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WELCOME 
to The MagP1 113 


still remember picking up my first Raspberry Pi 
| computer like it was yesterday. I built a small two- 
wheeled robot and got all the likes on Facebook. 
One thing led to another, and here I am editing this 
incredible magazine. 


Everybody has to start somewhere, and this month Hattersley 
we’ve put together a Get Started with Raspberry Pi feature Lucy is editor of 
(page 30). This article helps newcomers put together a de eae 
Raspberry Pi, install the Raspberry Pi OS operating system, a 
and discover basic electronics with GPIO. It’s perfect for ERU 


magpi.cc 


Raspberry Pi newbies. 
We've also got the best Starter Kits (page 82) and some 
great beginner-friendly tutorials. Whether it's creating 
Pong controllers (page 40), building a binary clock (page 58), 
or using sensors to build your own Weather Station (page 
50), there are some great ideas here for Raspberry Pi fans. 
Rob has also put together a great feature on Gaming with GET A 
Raspberry Pi (page 68). | РІ ZERO Ww 
Not retro gaming, but the 
full-on, modern video 
games you can play with an 
amazing $35 computer. 
Raspberry Pi comes from 
humble beginnings, but 
every month it gets better. 
We can’t wait to see what 
Raspberry Pi does in 2022! 


re 
| YOUR OFFICIAL RASPBERRY " MAG 
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Lucy Hattersley Editor 
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Old School 
Minitel Laptop 


From Minitel to a near-mini laptop, Gauti 
used for France's innovative online servic 


er Serodon has repurposed a terminal once 
e in the 19805, as David Crookes explains 


Gautier 
Serodon 


Gautier is an 
engineering student, 
as well as an 
electronic and DIY 
enthusiast. He enjoys 
retro tech, vintage 
cars, watchmaking, 
3D printing, and 
board games. 
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Wide Web, France had a hugely popular 

telecommunications service called Minitel. 
It allowed the country's citizens to book train 
tickets, check their electronic mail, search the 
telephone directory, and access online banking 
among other things, attracting an estimated 
25 million users and offering around 26,000 
services at its peak. 

Launched in 1982 and remaining in use for 
exactly 30 years, it was far ahead of its time. 
Anyone who wanted a terminal to connect to 
Minitel could get one for free from what became 
France Télécom, and this led to 9 million sets 
being installed in homes by 1999. But since Minitel 
closed, many have ended up being sold. “It’s easy 
to find a terminal on sale for below €10,” says 
French maker Gautier Serodon. 

Having snapped one up himself at a garage sale, 
the 25-year-old decided to bring it back to life. “1 
ove retro tech and I wanted to revive my Minitel 
with today's technology," he says. He decided a 
Raspberry Pi 3B computer would enable him to do 
just that. “It’s affordable, compact, and internet- 
compatible," he explains. And the plan? To convert 
it into a battery-powered laptop so he could take 
notes during his engineering school classes. 


p rior to the development of the World 


Key to authenticity 
Gautier bagged himself a Minitel 1B terminal, 
made in 1982 by Telic Alcatel. He stripped it of 
most of its parts, including the CRT display, but 
decided he wanted to at least retain use of the 
terminals original - and satisfyingly clicky – 
AZERTY keyboard. 

He also kept the power button and power 
indicator. *I wanted to keep as much of this 
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A It may not the sleekest of ‘laptops’, but his charmingly 
bulky piece of retro kit is still portable 


charming old technology as possible,” he tells us. 
“The power button and the LED played an important 
role in maintaining the aesthetics of the Minitel.” 
The screen was replaced by a 10.4-inch LCD 

panel which came complete with a driver board and 
this was fixed within the Minitel casing using four 
3D- printed parts, one for each corner. The biggest 
challenge, however, involved retrofitting the old 
Minitel keyboard so that it would simulate a USB 
HID keyboard that Raspberry Pi could work with. 
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Minitels were first used 
to find phone numbers 


Thousands more 
Services were 
later added 


The World Wide 
Web rendered 
Minitel obsolete 


A small number of 
QWERTY terminals 
were made 


This project is 100 
percent open-source 


The project runs Raspberry Pi OS, 
with the config.txt file having been 
edited to configure the screen size 


The Minitel terminals cost about 1000 francs to 
make, but they were distributed free of charge. 
Users would pay about 60 francs per hour to use it 


Gautier needed to determine the combinations for 


each key. “I would press a key, measure the Ohm with 4 47 The original power button was 
amultimeter, and note the combination, repeating for retained, with this light indicating 
all keys, so | could write the Arduino code,” he says the system is turned on 


~ 
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Warning! 
CRT 


Be careful with projects 
involving old television 
and CRT equipment. 
Opening up a CRT can 
be dangerous, risking 
electric shock even if the 
TV is not plugged in. 


magpi.cc/crt 


P Here you can see 
the internal wiring, 
connecting the 
screen (laid flat) to 
Raspberry Pi fixed to 
the right of the case 


У An HDMI cable 
connects Raspberry 


Pi to the display. You 
could easily upgrade A Given it dates back to 1982, Gautier's Minitel terminal - 


to Raspberry Pi 4 bought from a garage sale - is in surprisingly good condition 
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The bulk of the electronics are behind the 
Minitel's screen and need to be removed. A 
new screen is fixed using printed parts. STL files of 
these are provided by Gautier. 


2 It's possible to plug an Ethernet cable 
directly into Raspberry Pi too Л 


*The Minitel keyboard is a matrix with a 17- A. This is the keyboard 
: » : 5 « matrix Gautier used, 
wire output cable, Gautier explains. When you with eight columns 
retrofit a matrix keyboard, the goal is to find the and eight rows 
wires of the columns and the wires of the rows - in 
this case, there are eight rows and eight columns, 


making a keyboard with a maximum of 64 keys." 


Looking rosy 
Gautier used an Arduino Pro Micro which has an 
ATmega32U4 microcontroller on board. “This is 
the easiest way to emulate a keyboard,” he says. 
“Other boards such as the Arduino Nano don’t 
have the same microcontroller, so it’s way more 
difficult to simulate a keyboard without modifying 
the bootloader and other things.” 

From this point, the main work involved fixing 
a Raspberry Pi in place and connecting it to the 
keyboard, a DC step-down converter, and the 
power switch. “I placed Raspberry Pi right behind 
the Minitel’s hatch [located behind the screen] 
so that it is easy to plug in a dongle for a wireless 
mouse," Gautier says. "It's possible to plug an 
Ethernet cable directly into Raspberry Pi too." 

Allin all, it makes for a very neat setup, one that 
is powered by a 12V Li-ion rechargeable battery for 
portability. Gautier doesn't attempt to emulate the 
Ul of an old Minitel system - “I’m simply running 
Raspberry Pi OS," he says - but it still givesa 
flavour of what it was like to use the system. “It’s 
just a shame I never had the chance to use a Minitel 
for its original applications,” he laments. M 


A Minitel contains a simple matrix keyboard. 
The matrix is constantly scanned, allowing it to 
detect when a key is pressed and a circuit is closed. 

It must be mapped. 


Now the case can be kitted out with Raspberry 
Pi (in a 3D-printed case), a battery, a light 
indicator, and power supplies. Hot glue is used to affix 
the components. 
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PicoLight 


If you need an adjustable light, this neat little project might 
illuminate the way. Nicola King admires a glowing make 


Alexandra 
Covor 


A maker and 
embedded 
engineer from 
Bucharest, 
Romania. She 
loves playing with 
microcontrollers 
and blinky LEDs, as 
well as combining 
beauty and 
functionality when 
designing PCBs. 


zalmotek.com 


» Raspberry Pi Pico is 


surface-mounted 
on the rear of the 
NeoPixel matrix PCB 


12 | magpicc | PicoLight 


s active members of the open-source 
A hardware community, Bucharest-based 
makers Alexandra Covor, Constantin 
Craciun, and Mihnea Stoica regularly post project 
tutorials for the wider community. Impressive 
images of their projects are essential in order to 
ignite interest. However, finding the right light 
to shine on their endeavours was becoming a 
challenge, so like all good makers, the team decided 
to make their own. 
PicoLight is the result - a Raspberry Pi Pico- 
based, minimalist adjustable light which is 
perfect for low-light photography, as project lead 
Alexandra shares: “Studio lights are great, but 
they are often too big and too bright for our tiny 
hardware] projects, so this is where PicoLight 
comes in, being ideally sized." 


Small but mighty 
Alexandra describes PicoLight's user experience 

as “pretty simple”. It's made up of two fully 
customised PCBs and an acrylic panel sandwiched 
together. One PCB is a LiPo battery shield including 
a charging circuit and a power switch, while the 
other PCB is a 4x4 NeoPixel matrix with a Raspberry 
Pi Pico soldered onto the back. It also features a 
rotary encoder with a push-button, *used to switch 
between the functioning modes: colour adjustment, 
brightness adjustment, and rainbow mode, in 
which the LEDs cycle through all the colours." 


A The 4x4 NeoPixel matrix in rainbow cycle mode 


The team initially connected an external battery 
to Pico's micro USB port, but Alexandra says that 
they soon realised that portability was key, “so we 
ended up designing our own battery shield as well." 


m Some of our photographer 
friends asked for PicoLights 
to use in their shoots Л 


All of this has resulted in a very neat-looking and 
compact end product. As the PicoLight measures 
just 52x52 mm, they were a little concerned about 
how they would fit all of the features on it, but 
“then it hit us that we can actually build vertically, 
and add a new layer for every new feature we want 
to integrate, such as the battery charging module," 
says Mihnea. 

They've found it a useful tool on a day-to-day 
basis and while PicoLight's main purpose is adding 
a “dash of colour to macro photography... we've 
also used it to add a rather nice touch to video 
calls," Mihnea adds. 


In the limelight 

The response to PicoLight received so far has been 
hugely encouraging. “PicoLight ended up being 
much more popular than we've expected," says 


Diffused by an acrylic panel, 
the light from the NeoPixels is 
used to illuminate photo shoots 


Alexandra. “Some of our photographer friends 
asked for PicoLights to use in their shoots.” 

While considering a few improvements, 
including the possibility of using the RP2040 chip 
on a custom board rather than the entire Pico, 


Constantin tells us that since the feedback has been 


So positive, and everybody asked where they can 
buy it, they are pondering crowdfunding the project 
to bring it to mass production. 

The team are well-accustomed to using 
Raspberry Pi boards in their projects. *We have 
worked a lot with Raspberry Pi development 
boards for various IoT projects," says Constantin, 
*]ike automated points of sale, magic mirrors, 
and automated crypto trading bots to name a 
few, and we are excited about exploring the Pico 
microcontroller range." 

They have also, generously, made this project 
open-source, as Constantin explains: “We foresee 
using the Raspberry Pi variants in lots of future 
projects since they offer so much flexibility and 
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the support of the community is so good. We're 
also actively giving back whenever we can by open- 
sourcing our [Raspberry] Pi-based projects." 

If you'd like to try and make your own PicoLight, 
step-by-step instructions are available on Hackster 
(magpi.cc/picolightguide), and Mihnea thinks 
that any intermediate-level maker with a hot 
plate or DIY reflow oven would be able to achieve 
this make, as the right tools *make short work of 
this project." El 


The rear PCB is a LiPo battery 
Shield with a charging circuit 
and power switch 


The main PCB hosts the 4x4 
NeoPixel matrix and a Pico 
soldered onto the back 


Quick FACTS 


» PicoLight took 
three months 
to develop 


» Components 
include a Raspberry 
Pi Pico along with.. 


» .a custom acrylic 
panel, and rotary 
encoder with 
push-button 


» The software run 
by Pico is written in 
CircuitPython 


» See some of the 
team's projects 
at magpi.cc/ 
zalmotek 


44 The NeoPixel PCB is 
sandwiched between 
an acrylic diffuser 
panel and the LiPo 
battery shield 


PicoLight | magpicc | 13 


ШШЕН Mägi | PROJECT SHOWCASE 


Big Boxes 


Social enterprise Jangala provides internet access to communities 
affected by disasters. Rosie Hattersley hears their big idea 


Rich 
Thanki 


The possibilities 

of wireless 
connectivity led 
community- 
minded Rich, a 
self-confessed 
electronics tinkerer, 
to co-found a non- 
profit helping others 
get online. 


janga.la 


w Each box provides 
secure wireless 
access, weighs just 
1.9 kg, and fits ina 
small backpack 


ARAR 
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natural disasters, web access provides a 
critical lifeline. 

Not-for-profit organisation Jangala provides 
internet access for displaced people. The 
organisation was born out of its founders’ 
involvement in humanitarian relief efforts. These 
included the Amatrice earthquake in central Italy 
in 2016 and supporting refugees living in Camp de 
la Lande, Calais. 

Jangala’s ruggedised Big Boxes provide web 
access in challenging environments and, witha 
recent Raspberry Pi upgrade, are now capable of 
offering connectivity to multiple users via almost 
any wireless means. Their mission is to connect 


r or communities affected by man-made or 


every school, clinic, and community resilience 
project worldwide. In 2019, the project won a 
Tech4Good Africa award, having supplied internet 
access to 50 students at a refugee camp in Kenya, 
enabling them to complete their diplomas. 


The Big Easy 

Jangala co-founder and head of technology Rich 
Thanki has been fiddling with gadgetry and taking 
electronics apart “as long as I can remember”. 

A huge fan of wireless technology, Rich worked 

on projects with Microsoft bringing connectivity 
to people in sub-Saharan Africa before founding 
Jangala with Samson Rinaldi, who managed the 
CAD and hardware design aspects. 

Each Big Box is a briefcase-sized device, 
designed to be simple to set up and take advantage 
of an available wireless connection to offer WiFi 
access to hundreds of users at a time. “Scalable 
high-quality WiFi without the need for costly 
technical expertise" characterises Jangala's single- 
box approach to providing internet access when 
and where it may be needed. 

This is the first of Jangala's projects to use 
Raspberry Pi products. *I think the first of many," 
says Rich. 

Jangala’s updated purple box is now faster, more 
capable, and more rugged, the team explains, with 
the wireless antennas having been moved inside 
the box to protect them from the elements, plus 
twin modems that allow Big Box to connect to 
networks ranging from 2G networks to 5G. It was 
largely this aspect that prompted the switch to 
Raspberry Pi since it can handle the gigabit speeds 
that 5G networks offer. 


Jangala has set 
up 20 Big Box 
installations so far 


They provide web 
access to more 
than 25,000 users 


Jangala's Get Box 
provided UK users 
with web access 
during lockdown 


Each Big Box has a 
4G global modem 


It can also connect 

І х \ via satellite 
Спаи I 

Theruggedised purple — = 

boxes are briefcase 

sized and stuffed with 

enough electronics to 

connect hundreds of 

users wirelessly 
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RA 


Big Boxes support 
gigabit wireless and 
can be booted and 
updated remotely 
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Upgrading from a 
previous system to 
Raspberry Pi resulted 
in far more power, 

the need for a cooling 
system, and the ability 
to connect to anything 
from 2G to 5G 
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A. Deployments include 


refugee camps such 
as this one for exiled 
Rohingyans 

Credit: DFID, Rakhine 
camp, Myanmar 


Delivery of Big Boxes at 
Kakuma refugee camp, 
Kenya, where they will 
help support women 
and disadvantaged 
youths gain education 
and employment 


Other components were sourced from “absolutely 
all over the place", but the use of OpenWRT 

and the support of the Linux community were 
absolutely crucial. Rich also credits amazing 
manufacturers in China who designed the 
incredibly useful things that can't be found 
anywhere else, *everything from the perfect boost 
converter to little waterproof slots for SIM cards". 


m Without the stable base 
provided by Raspberry Pi, 
things would've gotten 
hairy quickly Ej 


Tech for good 

“The role of Raspberry Pi in Big Box is essentially 
to run the show,” says Rich. “It’s really the 
brains and brawn of the system. We are able to 
control and see Big Boxes in the field by talking to 
Raspberry Pi. It routes every bit of traffic, which 
is no easy feat. We've a unique software setup to 
ensure security and it's remotely updatable, so we 
have to use U-Boot as a second-stage bootloader. 
Without the stable base provided by Raspberry Pi, 
things would've gotten hairy quickly." 


Rich says working with Raspberry Pi 4 has been 
great because of the community, really accessible 
documentation, and standards that are open- 
source. “It’s made a huge difference for us. We 
wouldn’t have been able to do this on any other 
device,” he notes. 

Although Big Box is Jangala’s first Raspberry Pi 
experience, it won’t be their last. “Our next two 
projects will tackle other aspects of infrastructure 
which are really important in humanitarian 
settings, mainly power and edge computing. In 
both these cases, Raspberry Pi provides things that 
could easily be at the heart of these projects.” 

For anyone else planning on designing products 
for social good, Rich says, “Focus on what you have 
to do to get the design into the hands of people 
and making a difference as soon as possible. This 
might run against the grain of people who want 
to be perfect and neat. Don’t let the perfect be the 
enemy of the good.” Hl 


A. Big Box and Lenovo devices 
support online education 
courses in Kalobeyei 
settlement, Kenya 


A. The boxes provide internet 
access to aid workers, 
refugees, and remote 
communities such as this 
one in Kenya 
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n. 9.5, 


Each Big Box provides internet access 
for more than 100 users, with additional 
connections added via extra radio controllers. 

Raspberry Pi provides the "brains" of each box. 


The setup includes a PoE (Power over 
Ethernet) switch, a 4G global modem, and 

wireless access point, plus bespoke, highly efficient 
power management. 


Due to the demanding locations in which 
Big Boxes are deployed, the ruggedised 
boxes need to be fully waterproof, including their 
connectors and 'glands: 
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Virtual 
birthday cake 


This virtual birthday cake hides a delicious surprise, although 
Rob Zwetsloot had to settle with the Minecraft-powered part 


hile some (us) might argue that the best explains. “In 2021, I was faced with the problem of 
W part of a birthday cake is the cake itself, not being able to blow out candles on the cake... A 


there’s definitely something to be said virtual cake controlled by miniature wind turbines 
for an interactive model cake that does stuff in seemed the obvious solution. I’d recently started 
Minecraft. Also, there is a real cake underneath it developing web applications for research and 
all after you've finished with the virtual stuff. education in surgery, so it made sense to reuse these 
“The virtual cake consists of a looping video skills for the virtual cake.” 


of a cake created on Minecraft with nine candles 


се that can be blown out by spinning miniature wind Virtualising baked goods 
turbines on a matching physical model cake,” While something like this could be in some way 
A research engineer Stephen Thompson, the creator of this cake, tells achieved in Minecraft Raspberry Pi Edition, that was 
at the Wellcome/ us. “Once all the candles are blown out, the birthday not why a Raspberry Pi was used. 
EPSRC Centre child can lift the model cake to reveal an edible cake “Raspberry Pi provided an easy way to interface 
for Interventional eee ; " : i n 
and Surgical which is mercifully free of children's saliva." with the analogue-to-digital converters needed 
Sciences, and Code Sounds a bit more tasty and clean when you put to read the wind turbine voltages," Stephen says. 
Club mentor. it that way. * Along with sufficient computing power to serve a 
magpi.cc/ “T have always enjoyed making my children’s web application from within the cake itself, using 
sthompson birthday cakes, with a firm belief that form and Raspberry Pi enabled me use the same software 
function are as important as flavour,” Stephen architecture (Python, Flask, HTML) as I have used 
professionally. Sourcing the right HAT to measure 


nine voltages was very easy.” 

The virtual cake instead uses looping video 
overlaid with candle GIFs served via a web app ina 
clever way, as Stephen explains: 

“The application uses Flask to serve a web page 
which any device on the local network can access... 
a JavaScript loop is used to repeatedly send a POST 
request to the web server asking for the voltage 
from one of nine analogue-to-digital converters 
(the ADC board can support up to 16 candles). The 
code to interface with the ADCs and reply to the 
POST requests is written in Python and utilises the 
Flask and gpiozero libraries. All the code is available 
on GitHub (magpi.cc/sthompson).” 


b The building of the 
cake is a serious and 
exact procedure. 
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This cake model 


hides a delicious real 
cake underneath it 


L . i » The model cake 
е was built from 

spare pieces 

of wood 


v 


Stephen's son, 
SamueL built the 
Minecraft version 


v 


Stephen's work 
helps develop 
augmented reality 
software for 


surgeons... 
> .. that aims to 
The digital candles better utilise open- 
are blown out by source software 
blowing on to create open 
the turbines and reproducible 
, Science 
These little turbines 
will spin when blown » The wind turbines 


upon, which is sensed Е ; я are actually mini 
by the system A m. = r É generators for 
| education 


"d 4 The guests quickly 
figured out what they 
А had to do to blow out 
- 4 the candles 
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Sawing the wood for 
the model and the 
mini wind turbines 


There is space under 
the model cake for the 
electronics and the 
real cake 
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| was slightly nervous 
that the children would 
find it too abstract, 
but they worked it out 
pretty guickly 


Proof in the dessert 

Despite the best efforts of developers, sometimes 
an interface is not always clear to the user — 
especially when they've just turned nine. 

“I was slightly nervous that the children would 
find it too abstract, but they worked it out pretty 
quickly," Stephen mentions. “They saw the 
connection between the plastic wind turbines on 
the cake and the candles on the screen, and worked 
out that you could turn the on-screen candles off 
by blowing on the wind turbines. There was much 
laughter and smiles. The children were also very 
pleased to discover that there was actual cake 
underneath it all.? 

If only there were cake underneath every 
interactive Raspberry Pi project. 
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Cause and effect 


01 Blowing on the wind turbines generates 
a small amount of voltage, enough to be 
detected as a change using an ADC. 


A A small mess of wires 
ready to be hooked 
up to Raspberry Pi 


> The model was made 
from scratch 


02 Ascript that continually checks the voltage 
of each turbine written in JavaScript will get a 
response from Raspberry Pi via Python and Flask. 


03 If voltage is detected from a turbine, it means 
it's being blown on, and the candles are ‘blown 
out’ in Minecraft by changing the animation that is 
being presented. 
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Environmental 
cargo logger 


Keeping sweet potatoes sweet using data from a Raspberry Pi 
data collector. Rob Zwetsloot checks the results 


Thinus 
Prinsloo 


A Regional Manager 
for an IT company 
who doesn't have to 
code any more but 
still enjoys doing it. 


b The components аге 
all spread out inside 
the container 


the Netherlands takes a while. It's a long 

way, and one farm wanted to figure out what 
the potatoes went through on their 40-or-so day 
journey. This is where Thinus Prinsloo came in. 

“T was approached [by Zilverstoom Farms] to 
come up with a solution to monitor a cargo of sweet 
potatoes on their sea voyage to the Netherlands," 
Thinus tells us. “They wanted a visual record of 
the inside of a cargo bay for the duration of the sea 
voyage. The idea was to put a logger in a bin with 
sweet potatoes and log the environment in the bin 
for 40* days, taking daily photos of the cargo. Once 


G etting sweet potatoes from South Africa to 
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the logger arrived in the Netherlands, the data 
were collected from the USB drive and sent back to 
Zilverstroom Farms." 

For this project's requirements, a Raspberry Pi 
Zero became the obvious choice for Thinus. 

*There are numerous commercial environment 
loggers on the market to monitor cargo, but the 
client also wanted to have a visual record of the 
whole sea voyage. The requirements for the logger 
system were: to be powered by battery, low power 
consumption, low component costs, to allow the 
use of custom programming code, [and] consist 
of easy-to-come-by, off-the-shelf components. 
They also wanted flexibility - the ability to reuse 
the system components for other projects in the 
future. The sensor readings and photos would also 
be stored on a USB flash drive for easy collection... 
Raspberry Pi Zero checked all the boxes for the 
above requirements." 


Potato stats 

Running continuously for 40 days is no real 
problem for a Linux- powered box like Raspberry Pi 
- there are several out there that have logged over 
1000 days’ uptime - however, there's no handy 
plug socket for Raspberry Pi to use here. 

To conserve as much power as possible, a PiJuice 
HAT with a power supply and a real-time clock was 
used to power on the system once a day for just five 
minutes to do its job. 

*Once Raspberry Pi was switched on, the 
temperature, humidity, and atmospheric pressure 
readings were taken and written to the USB flash 
drive," Thinus explains. “As a failsafe, the data is 
also written to the SD card of Raspberry Pi.” 

Thinus describes it working as follows. 

During the start-up process, crontab events 
at reboot are scheduled to: 
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» Thanks to a mobile 
battery, the logger 
can operate for 
50 days 


v 


A Raspberry Pi Otherwise, with just 
Camera Module takes PiJuice, it runs for 
photos as part of the up to 30 days 
sensor readings 
Lights are used 4 ч CB Pi Juice will only 
to illuminate the — "A -— о wait for ten minutes 
potatoes when — for Raspberry Pi 
photos are taken к Zero to turn оп 


v 


An enclosure was 
laser-cut for 
the project 


v 


Once a day, the 
system is turned on 


v 


Some people call 
to take readings sweet potatoes 
yams, but they are 
not true yams 


4 Photos show how the 
inside of the container 
looks during the journey 


* Take a photo after 45 seconds using a Bash 

script to: 

- Switch on the bright LED and take a photo 
with the Pi camera and save it to the SD card 

- Switch off the bright LED and switch on the 
infrared LED 

- Takean infrared photo with the camera and 
save it to the SD card 


4 The potatoes and 
logger are ready for 
the long journey 


- Copythe photos to the USB drive Tuber analysis 
Using results from the logger, the farm has put 
* Read the sensor data after 30 seconds with a measures in place to reduce transit time for their 
Python script: sweet potatoes. The data also revealed some 
- Write the measurements for the interesting stats, such as the big temperature shifts 
temperature, humidity, and atmospheric mainly occurring on the 1000 km journey from the 
pressure to a log file on the SD card farm to the harbour, and the unloading of the cargo at 
- Copy the log file to the flash drive the destination. The potatoes also noticeably shrank 
over the course of the journey. 
* Set the PiJuice shutdown trigger for shutting “It worked very well, and for longer than 
down using a Python script. anticipated,” Thinus mentions. M 
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An optical sensor detects when 


the camera is moving, after the 
record button has been pressed 


Switching film for Raspberry Pi-based digital 
capture transformed one creator's videography, 
as he relates to Rosie Hattersley 


2000s, there was an abrupt switch from 
film to digital photography and video, 
but there are plenty of analogue cameras and 
video cameras still around, and some that 
even earlier recording methods, such as 8mm 
cassette. Photography and film enthusiast Bennet 
Fischer spied an opportunity to retrofit his old > 
film cameras and camcorders and go digital using 
Raspberry Pi, resulting in the Super 8 Kamera, 


Q ver just a few short years in the early 


Bennet Fischer 


With a PhD in 
robotics and a 


day job working 2 An electronic film cassette 


on mapping and 


camera-based ' 

assistance, Bennet's that can be plugged Into 

an accomplished 

coder and any Super 8 camera and 

keen upcycler. 

github.com/ make it usable again Ø 

befinitiv 
one of several upcycling projects he's undertaken. time, he focuses on building projects that spark his 
Modernising retro tech items is satisfying, he curiosity. “Raspberry Pi is a perfect platform for 
explains, “not only because it makes them useful such projects because it eliminates most burdens 
again, but also because of the unique experience", that come with building embedded devices," he 
citing his enjoyment of programming Python web says, citing the “excellent” Raspberry Pi and open- 


applications on a 286 laptop, orlive-streaming full source software communities. 
HD video on a 50-year old SLR camera. 


Bennet is lucky enough to have a job that Mechanical marvels 
involves imagination, invention, and problem- Super 8 cameras are “mechanical marvels that are 
solving. An engineer and professor of robotics, destined to sit unused in drawers simply because 
his role involves work developing mapping and you cannot buy the film cassettes any more," 
camera-based assistance programs. In his free he opines. And if you could, he calculates three 
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Raspberry Pi Zero W and a 5 MP 
Raspberry Pi Camera replace 
the original film cartridge 


Analogue video tape is hard 
to come by, prompting Bennet 
to find a way of bringing the 
Super 8 camera back into use 


Ww 


Quick FACTS 


> Bennet enjoys 
finding new ways 
of using old 
technology 


v 


The Super 8's 
original battery had 
leaked badly 


He had to cut 
out and replace 
most of the 
original wiring 


v 


The camera 
attracted attention 
because it was 


v 


quite noisy 
» Few people 
* Replacing the obsolete recognised what 
8mm recording medium the S 8 
results in instantly viewable е Super 
30 fps video capture camera Was 
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Movie making makeover 


This project uses Raspberry Pi Zero W, a 
Raspberry Pi Camera, and Bennet's adapted 
version of the picamera API code. Download the 
code from magpi.cc/campy, and the CAD files from 
magpi.cc/digital8cad. You'll also need an external 
power bank. 


Trim down your Raspberry Pi Camera to the A eee le {e minutes of footage would cost around €60 to 
bare sensor chip. Be aware that cutting away to decades-old photos develop. Troubled by this wasted potential, Bennet 
its plastic parts with a craft knife requires patience, decided to create “an electronic film cassette that 


precision: andicare: can be plugged into any Super 8 camera and make 


it usable again.” He used Raspberry Pi Zero W with 
a5MP camera mounted on a flex circuit board. He 
chose Raspberry Pi for the Zero W’s compact size 
and low price, plus the “excellent software support 
of camera and video encoder hardware.” He was 
also attracted by the possibility of adding wireless 
live video streaming. 
Another important factor was that Bennet had 
recently put together a very similar project for an 
SLR still camera - involving fitting a Raspberry Pi 
Zero W completely inside the camera - which had 
proved popular (see magpi.cc/digitalfilmcart). He 


See the instructions at magpi.cc/super8video 


for details of how to complete the setup, hoped to use the same idea for the Super 8 camera. 
including the photoresistor and motion-detecting LED He was able to source the hardware including a 
to recognise when the spindle moves. photoresistor and motion-detecting LED from a 


supplier, Riechel, for around €50, and wrote code 
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for the Super 8 Kamera 
project using the custom 
Python program and 

the picamera API. This 
program monitors the 
light detector for changes 
(such as when the user 
presses the camera's 


A Bennet has also 


record button) and starts recording and streaming Super 8 camera chassis involved three design successfully 
at the same time. While Bennet's code is specific versions. *It was quite hard to make the hardware a 
to the Super 8 video camera, both the project fit into the cartridge. The camera placement and Raspberry Pi Zero W 
idea and the picamera API can be adapted for use its cable proved to be an especially challenging 
with other camera and video camera models. See origami riddle,” he comments. The results, 
magpi.cc/bullseyecamera. however, were more than worthwhile: “It surprised 
me how much the digital footage looks like the 
Fantastic facsimile original Super 8 movies. I did not implement any 
Bennet spent around ten hours designing and post-processing to make it look more like the 
3D-printing the hardware, assembling the original film, but still it looks remarkably similar. 
electronics, and writing the software. Fitting This gives the movies generated by my system a lot 


everything together so it fitted within the original of character and a certain patina.” El 
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Set up your Raspberry Pi computer with Raspberry 
Pi OS, the latest version of the operating system and 
discover all the new features. By Phil King 


hichever model of Raspberry Pi you have, it is part of the 
most creative computer family on Earth. With a Raspberry Pi, 
you can hack, make, and build all kinds of different things. It 
could be a digital camera, a retro games console, or a home media centre. 
You could even control a sensor on board the International Space Station 
if you submit an entry for the Astro Pi missions (astro-pi.org). 
In this guide, we show you how to get started with Raspberry Pi 
using the new Debian ‘Bullseye’ edition of Raspberry Pi OS, as well as 
connecting and controlling some basic electronics. 


30 magpi.cc Get Started With Raspberry Pi 


MN Mägi | FEATURE 


USING RASPBERRY PI 
OS (BULLSEYE) 


Explore the latest version of the default operating system 


o make a Raspberry Pi work, you'll need 
T to install an operating system. Unless 

your Raspberry Pi came with one already 
preloaded onto a microSD card, you'll have to 
write the OS to the card. 

While other operating systems are available for 
Raspberry Pi (check out our feature in The MagPi 
#111, magpi.cc/111), the official one is Raspberry 
Pi OS, which has recently been updated to the 
‘Bullseye’ version of Debian Linux. 

It’s easy to install 
Raspberry Pi OS onto a 
microSD card using the 
Raspberry Pi Imager tool 
— download it on another 
computer (Windows, 
Mac, or Linux) from magpi.cc/imager. See the 
‘Installing Raspberry Pi OS’ box for details. 

Upon inserting the microSD card with the OS 
on it into your Raspberry Pi's slot and powering 
up, it will first expand the file system before 
booting to the Raspberry Pi OS desktop. The 
Welcome to Raspberry Pi wizard will take you 
through configuration options including language 
and time zone, prompt you to change the default 
password, ask whether all of the taskbar fits on 
the screen, and prompt you to connect to your 
wireless router by entering its password. 

You'll also be asked if you want to check for and 
install any software updates, which you can do 
or skip for now. With setup complete, you'll be 
prompted to hit Restart to reboot your Raspberry 
Pi. This time it'll boot straight to the desktop, 
without the wizard, and be ready to use. 


Explore the desktop 
Like most operating systems, the standard version 
of Raspberry Pi OS comes with a desktop interface 
that you can navigate with a connected mouse. 
The default web browser in Raspberry Pi OS is 
Chromium, although you can install others such 
as Firefox ESR, Midori, Vivaldi, and Puffin. 
Chromium is the basis for Google Chrome, so 
you may well find its user interface very familiar. 
There's an Omnibox where you can enter web 
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2 You'll need to install an 
operating system @ 


addresses or search terms. The default search 
engine is DuckDuckGo, which is focused on 
preserving the privacy of searchers, but can be 
changed in the Settings (after clicking on the 
three dots icon in the top right). 

One drawback is that you can't sync your Google 
account in Chromium to use the same bookmarks 
and settings that you have in Chrome; Firefox 
is an alternative browser that enables cross- 
platform syncing. Other than that, most features 
are present, including the 
ability to add extensions 
from the Chrome Web 
Store and also to group 
tabs together. You can 
also install web apps for 
some sites such as YouTube, by clicking the option 
that appears on the right side of the Omnibox. 


Install extra software 

The standard Raspberry Pi OS only comes with 
a handful of core applications pre-installed 

- although there is a ‘Full’ version of the OS 
supplied with a lot more software (find it in 
Raspberry Pi Imager, under ‘Raspberry Pi 

OS (other)’). 

It’s simple to install any extra software you 
want, however. By far the easiest way is to use the 
Recommended Software tool (Menu > Preferences 
> Recommended Software). You can then browse 
a range of applications; to install one, simply tick 
its box and click Apply. 

Applications in Recommended Software 
include the Claws email client and the LibreOffice 
productivity suite. The latter features six 
applications: the Writer word processor, Calc 
spreadsheet, Impress presentation, Draw 
diagrams, Base database, and Math formula editor. 
It can load/save Microsoft Office documents too. 

If you can’t find what you need in 
Recommended Software, you will be able to install 
additional software packages using the Add/ 
Remove Software tool, or by entering commands 
(such as sudo apt install and sudo pip install) 
in a Terminal window. 


М Applications menu: 


Click the Raspberry 

Pi icon to open the 
applications menu. This 
is divided into helpful 
categories such as 
Programming, Internet, 
and Sound & Vision - 
click on one to see its 
contents, then click 
an app name to open 
it. The Preferences 


category is home to 
some useful tools 


To install Raspberry Pi OS (or upgrade from 

an earlier version of Raspberry Pi OS to the 
latest ‘Bullseye’ edition), you will need to install 
a fresh version of the OS to your microSD 

card. Typically you'll do this using Raspberry 

Pi Imager (magpi.cc/imager) on a Windows, 
Apple Mac, or another Linux computer 
(including another Raspberry Pi). Open 
Raspberry Pi Imager on your other computer 


Taskbar: Shown at the top of the 
screen by default, the taskbar shows 
any open applications, including any 
that have been minimised. Right- 
clicking an empty part of the taskbar 
brings up the Panel Preferences 
dialog where you can alter its 
appearance and configuration 


Installing Raspberry Pi OS 


File Manager: Opening the File 
Manager, from the taskbar icon 
or applications menu, enables 
you to explore Raspberry 

Pi's file system. Like other 
application windows, you can E 
use the icons at the top right to 
minimise, maximise, or close it 


= ЖШ, Lt 
а= -x7 


and insert your microSD card (using a USB 
adapter if needed). Click ‘Choose OS' and 
select ‘Raspberry Pi OS (32-bit). 

Now click ‘Choose Storage’ and select 
your inserted microSD card (which may well 
be labelled as ‘Generic STORAGE DEVICE 
Media’ with its storage capacity). Click Write 
to download Raspberry Pi OS and copy the 
software to the microSD card. 


— ай 
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Terminal: Opening a Terminal 
window enables you to enter 
Linux commands. You may need 
to do this occasionally to install 
certain software packages 


System tray: At the top right of 
the taskbar, you'll see icons for 
Bluetooth, network (wireless 
or Ethernet), and audio, along 
with a clock. Right-clicking 
audio will enable you to 
choose the sound output used 
- by default it's via HDMI 


E 
nb 


Lr 


Raspberry Pi 
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Read digital PDFs of your 
favourite magazines by 
downloading issues in 
the Bookshelf app 


Find out what's changed in the new version of Raspberry Pi 0S 


magpi.cc 


ith the basics of the desktop GUI and 

core applications covered, let's take 

a look at some of the new features in 
Raspberry Pi OS Bullseye and the differences 
from previous versions. 


Get Raspberry Pi OS Bullseye by installing a fresh 
installation of the latest version of Raspberry Pi 
OS from Raspberry Pi Imager (magpi.cc/imager). 


You can’t upgrade from Debian Buster to Debian 
Bullseye using sudo apt full-upgrade - this only 
takes you to the latest version of the current (i.e. 
‘Buster’) operating system. You have to install 
Bullseye onto a fresh microSD card. If you have 
data on your Buster installation you want to keep, 
we recommend copying it to a separate drive and 
then back to the fresh Bullseye installation. 


Buster is now known as Raspberry Pi OS (Legacy) 
and is available from Raspberry Pi's Software 


Get Started With Raspberry Pi 


page (magpi.cc/buster). It can also be found in 
Raspberry Pi Imager. Read more about Raspberry 
Pi OS (Legacy) in Gordon Hollingworth's blog post 
(magpi.cc/legacy). 


If you've used Raspberry Pi OS before, you'll 
immediately notice that the default wallpaper is 
different in Bullseye. If you like, you can change it 
in Preferences » Appearance Settings. 

Another change you may notice is that desktop 
windows have a shadow effect on their borders, 
and animate as they open and close. Widgets and 
their tabs and buttons also look a little different. 

In File Manager, the view modes have been 
simplified, with icon options to switch between 
icons or list mode. For more advanced options, 
you can use the View menu to zoom the icon size 
in/out and select thumbnail icon mode. 


One of the numerous under-the-hood changes 
in Raspberry Pi OS Bullseye is that the KMS 
(kernel mode setting) video driver is now 


used by default, whereas previously it was an 
experimental option. 

While you may not notice much of a change 
in how the video display works or performs in 
general, one major advantage of using KMS is 
that it’s the standard open-source video driver 
used in Linux. This means that any application 
written using the standard Linux display APIs 
should run on Raspberry Pi without the need 
for modification. 

In addition, now that all the display drivers for 
Raspberry Pi OS are part of the Linux kernel, this 
should make it easier for manufacturers of custom 
displays to add support for Raspberry Pi. 

The upgrade to Bullseye brings with it an update 
of Chromium to version 92, which has also been 
optimised to use Raspberry Pi's hardware to 
accelerate video playback. 


m Bullseye takes its 
name from a character 
in Disney's Toy Story 
movie franchise @ 


Anything else new? 

The Bookshelf application now includes free 
downloadable PDFs of our sister publication 
Custom PC, the UK's best-selling magazine for PC 
hardware, overclocking, gaming, and modding. 
Bookshelf also contains issues of The MagPi, 
HackSpace, and Wireframe magazines, along with 
our official Raspberry Pi books. 


Will my Raspberry Pi run faster? 

There’s a speed boost bonus for owners of recent 
Raspberry Рі 4 and Raspberry Pi 400 models: the 
default turbo-mode clock has increased from 
1.5GHz to 1.8GHz. For more details, see Eben 
Upton’s blog post: magpi.cc/bullseyeboost. You 
can manually overclock many models of Raspberry 
Pi (magpi.cc/overclock). 


Why doesn't my Raspberry Pi have the 

new interface? 

The new look is down to the use of a new window 
manager called Mutter (magpi.cc/mutter). The 
switch to Mutter is due to the upgrade from СТК+2 
to GTK+3 for user interface components. Mutter 
replaces the Openbox window manager used 

in previous versions of the OS. Openbox is still 
employed if your Raspberry Pi model has less than 
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2GB of RAM, because Mutter is quite demanding 
in terms of memory usage. 


How do | manage notifications? 

Raspberry Pi OS Bullseye now has a common 
notification manager which tells you about things 
like USB devices being inserted/removed and low 
power supply voltage, and memory allocation. 

Notifications appear in grey windows under 
the right end of the taskbar, with the most recent 
messages shown at the top. Each notification 
will time out and automatically disappear after 15 
seconds, or when you click on it. 

The notification timeout setting can be altered 
in the Appearance tab of the Panel Preferences 
dialog, accessed by right-clicking the taskbar. 

If you set the timeout to zero, notifications will 
stay on screen until clicked. You can also turn 
notifications off completely (not advisable). 


How should | keep Bullseye up-to-date? 
Another major user-friendliness improvement in 
Bullseye is the introduction of an updater plug-in 
for the taskbar. Whenever you reboot Raspberry 
Pi, or every 24 hours if it's left powered up, it 

will check for any software updates and show 

an update icon in the taskbar with a notification 
telling you that updates are available. 

Click the update notification to open a window 
showing you the packages that can be updated. 
Just click the Install button to start installing 
them; you can then carry on with whatever you 
were doing while they install in the background. 


Why is it 'Bullseye'? 

Every major version of the Debian Linux distro, 
upon which Raspberry Pi OS is based, takes its 
name from a character in Disney's Toy Story movie 
franchise. Previous versions include Wheezy, 
Jessie, Stretch, and Buster. If you've not seen the 
movies, Bullseye is Woody and Jessie's horse, one 
of the new characters introduced in Toy Story 2. 
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Get to grips with using Raspberry Pi cameras with Bullseye! By David Plowman 


hen we released our first Raspberry Pi 

OS image based on Debian Bullseye, 

we pointed to a change that is hugely 
important to people who have written code to 
use cameras with Raspberry Pi: the driver that 
Raspberry Pi uses to access Camera Modules has 
been replaced with libcamera. 

These very significant changes mean less 
closed-source code, and they make it easier for 
people outside of Raspberry Pi to develop new 
camera hardware and software; but they also 
mean that new Raspberry Pi OS releases will no 
longer support the familiar raspicam apps and 
picamera Python library. 

In the place of this older camera system is the 
new and almost entirely open-source camera 
stack based on standard Linux frameworks such 
as V4L2 (Video for Linux) and libcamera. Our 
kernel drivers have been moving in this direction 
for some time too, and have just recently taken 
further large strides towards the preferred new 
Media Controller architecture. 


Libcamera-apps are designed to copy most of the functionality that users 
will know from raspistill, raspivid, and raspiyuv. There are some unavoidable 
differences, which are examined in greater detail on Raspberry Pi's 

documentation pages (magpi.cc/libcamdiff). The new applications include: 


libcamera-hello - a simple ‘hello world’ application that starts a 


camera preview stream and displays it on the screen. 


libcamera-jpeg - a simple application to run a preview window and 


then capture high-resolution still images. 


libcamera-still - a more complex still image capture application that 


emulates more of the features of raspistill. 


libcamera-vid - a video capture application. 


libcamera-raw - a basic application for capturing raw (unprocessed 


Bayer) frames directly from the sensor. 


libcamera-detect - this application is not built by default, but users 
can build it if they have TensorFlow Lite installed on their Raspberry Pi. It 


captures JPEG images when certain objects are detected. 
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But the principal difference that users will 
notice is that OS releases from Bullseye onwards 
will no longer support the older camera system 
and applications, and Raspberry Pi’s libcamera- 
apps will be built and pre-installed instead. 
Before we go further, note that Raspberry 
Pi OS Buster is still available to download if 
you’ re not ready to use Bullseye. If you are 
using camera applications with your Raspberry 
Pi, we recommend you take some time to 
weigh up whether to move to Bullseye at this 
point. A blog post on the Raspberry Pi website 
(magpi.cc/bullseyecamera) considers why, and 
why not, you might want to do so. 


David 
Plowman 


~ 


A version of Raspberry 

Pi OS based on the 

older ‘Buster’ system is 
available. Read about it 
on this Raspberry Pi post. 
magpi.cc/legacy 


For detailed information on 
Bullseye, straight from the 
horse's mouth. Read Simon 
Long's Bullseye blog post. 
magpi.cc/bullseye 


FEATURE | Маі 


Legacy Camera Support is a new option in 
Raspberry Pi OS (Bullseye). It replaces the "Enable/ 
disable connection to the Raspberry Pi Camera” 
found in Raspberry Pi OS (Buster) and previous 
Raspberry Pi operating systems. (You no longer 
need to to enable camera support in Rasperry 
Pi OS (Bullseye) as the libcamera API is enabled 
by default). 

Legacy Camera Support is included in the 
latest update to Raspberry Pi OS. Open a terminal 
window and enter: 


sudo apt-update 
sudo apt full-upgrade 


You will need to reboot Raspberry Pi OS for the 
changes to take effect (Menu > Shutdown and 
click Reboot). 

Use raspi-config to enable Legacy Camera 
Mode. In a terminal window enter: 


sudo raspi-config 


Chose ‘3 Interface Options’ and 1 Legacy Camera’ 
and select 'Yes' in the ‘Would you like to enable 
legacy camera support?’ window. You will see a 
message saying ‘Legacy camera support is enabled" 
along with ‘Please note that this functionality is 
deprecated and will not be supported for future 
development: Legacy Camera Mode will enable you 
to use Picamera-based projects with Raspberry Pi 
OS (Bullseye), but you should move your project to 
libcamera for future compatibility. 

See the Raspberry Pi Documentation for 
more information on using the raspi-config tool 
(magpi.cc/raspiconfig). 


Л воба 
ages on the serial connection 
e-wire interface 
enote access to GPIO pins 


Enable Legacy Camera Mode in raspi-config 
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CONNECTING ELECTRONICS 


Make use of Raspberry Pi's GPIO header to connect and control circuits. By Phil King 


hile Raspberry Pi can be used as an 
W effective desktop PC, a major bonus 

is that it can easily be connected to 
electronic circuits and add-on boards (often 
called HATs) via its 40-pin GPIO header. This is 
found on every Raspberry Pi model, including the 
tiny Zero 2 W and also the Pi 400. See the GPIO 
diagram below for details of pin functions. 

There's a wide variety of HATs (Hardware 

Attached on Top) and other expansion boards 
available for Raspberry Pi. On most Raspberry Pi 
models, the HAT just fits on top of the GPIO pins 
and is positioned over the computer's PCB. Since 
Raspberry Pi 400’s GPIO header is located at the 
rear of the keyboard unit and is slightly inset, 
however, you may well need a ribbon cable or 
breakout adapter to connect a HAT. 


3V3 power о 5V power 
GPIO 2 (SDA) 5Vpower 
GPIO 3 (SCL) Ground 
GPIO 4 (GPCLKO) GPIO 14 (TXD) 
Ground o GPIO 15 (RXD) 
GPIO 17 GPIO 18 (PCM. CLK) 
GPIO 27 о o Ground 
GPIO 22 GPIO 23 
3V3 power GPIO 24 
GPIO 10 (MOSI) Ground 
GPIO 9 (MISO) GPIO 25 
GPIO 11 (SCLK) GPIO 8 (CEO) 
Ground о GPIO 7 (CE1) 
GPIO 0 (ID. SD) GPIO 1 (ID. SC) 
GPIO 5 o o Ground 
GPIO 6 o GPIO 12 (PWMO) 
GPIO 13 (PWMT) о o Ground 
GPIO 19 (PCM FS) ^ o GPIO 16 


GPIO 26 o 
Ground о 


GPIO 20 (PCM, DIN) 
o GPIO 21 (PCM. DOUT) 


P Apart from power (3V3 and 
5V) and ground (GND) pins, 
most GPIO pins can act as 
an input or output; some 
have special secondary 
functionality such as PWM, 
12C, or SPI 


38 | magpicc | Get Started With Raspberry Pi 


Alternatively, connect and control your own 
electronic circuits to the GPIO pins using jumper 
wires. Standard electronic components such as 
LEDs, push-buttons, and sensors can be used, 
often via a breadboard (magpi.cc/breadboard). 


JAM HAT 

For this introductory electronics example we'll 
make things simpler by using a JAM HAT. 
Available from The Pi Hut (magpi.cc/jamhat), 
this add-on board features built-in LEDs, push- 
buttons, and a piezo buzzer. Just slot it onto your 
Raspberry Pi's GPIO header (or connect to Pi 400 
via a ribbon cable or breakout adapter). 


m Set up the LEDs as 
traffic lights and use 
a push-button for a 
pedestrian crossing Л 


You are now ready to start programming your 
first electronics project in the popular Python 
language. In Raspberry Pi OS, open the Thonny 
IDE (Menu » Programming » Thonny IDE). The 
easiest way to read and control the GPIO pins in 
Python is to use the GPIO Zero library. This even 
has a special class for the JAM HAT - at the start 
of our code, we import this with: from gpiozero 
import JamHat. 

So that we can incorporate a delay in our 
program, we also import the sleep method from 
the time library: from time import sleep. 

We then assign a variable, jamhat, to the JamHat 
class, with: jamhat = JamHat(). 

Now, to blink the two rows (lights 1 and 
lights 2)of LEDs in turn, we can use GPIO Zero's 
blink method: 


jamhat.lights 1.blink() 
sleep(0.5) 
jamhat.lights 2.blink() 


See the jam-LEDs. py listing for the full code. 
Run it in Thonny to see the effect. We can specify 
which colour LED in each row to blink. To turn on 
the red LED in row 1 for one second enter: 


jamhat.lights 1.red.on() 
sleep(1) 
jamhat.lights 1.red.off() 


Push the button 

We can also read the input (on or off) from 

the JAM HAT's push-buttons. We will use the 

when pressed method to check when the button 

has been pressed. We will also need to tell the 

program what to do when it is pressed, in this 3 
case turning on all the JAM HAT's LEDs and its 

buzzer using the jamhat.on command: 


jamhat.button 1.when pressed() - jamhat.on() J a m-LE D S. ру 


See the jam-button.py listing for the full code. » Language: Python 3 
Run it and every time you press button 1, the LEDs 
will light up and the buzzer will make a noise. 
Press button 2 to turn them off. 

There's a lot you can do with the JAM HAT, 


001. from gpiozero import JamHat 
002. from time import sleep 


: ; ; Do, 003. 
includi ng setting up the LEDs as traffic lights and дл. ашпа = Jamat) 
using a push-button for a pedestrian crossing. 005 


For more details, see the JAM HAT getting-started 
guide (magpi.cc/jamhatguide) and further code 
on GitHub (magpi.cc/jamhatgit). Ш 


006. jamhat.lights_1.blink() 
007. sleep(0.5) 
008. jamhat.lights_2.blink() 


У Making electronics easier, the 
JAM HAT features six coloured Р 
LEDs, two tactile push-buttons, -— 


and a buzzer p р 


jam-buttons.py 


» Language: Python 3 


001. from gpiozero import JamHat 
002. 
003. jamhat - JamHat() 


004. 

005. jamhat.button 1.when pressed 
jamhat.on 

006. jamhat.button 2.when pressed 
jamhat.off 
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Richard is an 
engineer who's 
easily distracted 
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rugby, and LEGO. 
His quest to 
combine them 
into a single 
activity is ongoing. 


raspberrypi.org 


Marc Scott 


Marc is a former 
computer science 
teacher, and 
manages informal 
learning content 
for the Raspberry 
Pi Foundation. 
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Here is our early 
one-player Pong 
game, with a white 
ballin the centre of a 
black window, with a 
single green paddle 
on the far Left 


Make a Build HAT 
game controller 


Build a Pong paddle-style controller using Build HAT and bricks 


Pi Build HAT, a LEGO® Technic™ motor 

encoder and wheel, and the Python Turtle 
library to make a simple game controller that 
you can use to play Pong. 

Pong is one of the earliest arcade video games, 
originally released in 1972 by Atari. It is a table 
tennis game featuring simple two-dimensional 
graphics. Players control paddles on each side 
the screen, which they use to hit a ball back 
nd forth. 
You will learn how to read the degrees of 
rotation from LEGO Technic motors, how to draw 
and move Turtle graphics using LEGO Technic 
motors, and how to detect collisions between 
graphics using x and y coordinates. 


| п this project, you will use the Raspberry 


о o 


Set ир Build HAT 

Before you begin, you'll need to have set up 
your Raspberry Pi computer and attached a Build 
HAT. If you have a Maker Plate™, mount your 
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Raspberry Pi to it using M2 bolts and nuts, making 
sure your Raspberry Pi is mounted on the side 
without the ‘edge’. 

Mounting Raspberry Pi this way round enables 
easy access to the ports as well as the SD card 
slot. The Maker Plate will allow you to connect 
Raspberry Pi to the main structure of your 
dashboard more easily (this is an optional extra). 

Line up the Build HAT with your Raspberry Pi, 
ensuring you can see the 'This way up! label. Make 
sure all the GPIO pins are covered by the HAT, and 
press down firmly. 

You should now power your Raspberry Pi using 
the 7.5V barrel jack on the Build HAT, which will 
allow you to use the motors. 

You will also need to install the buildhat 
Python library. Open a Terminal window on your 
Raspberry Pi and enter: 


sudo pip3 install buildhat 


Press ENTER and wait for the 'installation 
completed' message. 


Motor encoders 

Motor encoders can not only rotate: they 
can also accurately detect how many degrees they 
have been rotated. 

The LEGO Spike?" motors all have encoders. 
If you look at the rotating disc part of the motor, 
you will see a mark shaped like a lollipop that 
can be lined up with the o mark on the white 
body of the motor itself. This is the encoder set 
to zero degrees, and any angular movement 
of the motor shaft can be measured relative to 
this point. 

A motor encoder, also called a rotary or shaft 
encoder, is an electromechanical device that 
allows you to record the angular position or 


à d a Ne 
Build HAT enables you to control 
| , LEGO components with Raspberry 
Al Pi. Here, a motor is connected to 
| port A on the Build HAT and a large 


y 


wheel is attached to the motor 


FẸ 


и шаа г: 


The motor contains an encoder enabling it 

to detect its rotational position. Thanks to 

this, we can move the motor by hand, and 

use the encoder to detect the position, 

turning the wheel into a Pong-style paddle m 


A VEL Му 
p 


motion of the axle. It normally does this by 


converting the angular position to an analogue or 


digital output. 


If a motor has an encoder, that means you can 


very accurately set the position of the axle. 
allows you to use the motor as an input devi 


talso 
ce so 


that if something changes the position of the axle, 
this can be registered and used to trigger other 


actions in a computer program. 
Open Thonny from the Programming men 


u, 


click on the Shell area at the bottom, and en 


from buildhat import Motor 
motor_left = Motor('A') 


ter: 


Depending on how well you positioned the motor 
at the start, you should get a value close to ‘o’. 


Move the motor and type the second line aga 
and see how the value changes. 


in, 


React to motor 
encoder movement 


To use the LEGO Technic™ motors as a controller 
for a game, you’ ll need to be able to constantly read 


their absolute positions. 
In the main Thonny window above the Shel 


1, you 


can use the commands you already know to find 


the absolute position of the motor. Then, ina 


while 


True: loop, you can print the value of the position. 


Enter this code, save the file, and press Run. 


from buildhat import Motor 
motor left = Motor('A') 


while True: 
print(motor left.get aposition()) 


You should see that your program continually 
prints the position of the motor. If you rotate the 
motor, these values should change. 

There is a better way of doing this, though. You 
only need to read the motor position if it is moved. 
Delete the while True: loop from your program 

and create this simple function that prints the 
absolute position of the motor. You will also need to 


add another import line to use the pause() function. 


from buildhat import Motor 
from signal import pause 
motor left = Motor('A') 


def moved left(motor speed, motor pos, 
motor apos): 
print(motor apos) 


Now set this function to run when the motor's 
encoder is moved: 


from buildhat import Motor 
from signal import pause 


| You'll Need 


> 


v 


Raspberry Pi 
computer 


Raspberry Pi 
Build HAT 
magpi.cc/buildhat 


Assortment of 
LEGO, including 
wheels (we used a 
selection from the 
LEGO Education 
SPIKE Prime kit) 
magpi.cc/spikeprime 


Small breadboard, 
buzzer, and jumper 
leads (optional) 


.5V power supply 
with a barrel jack 
(optional) 
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Get started 


See The MagPi 
issue 112 for 

a quick guide 
to setting up 
Build HAT. 
magpi.cc/112 


P Figure1The 
co-ordinates for the 
game area in our 
version of Pong 


motor left - Motor('A') 


def moved left(motor speed, motor pos, 
motor apos): 
print(motor apos) 


motor left.when rotated - moved left 
pause() 


Run your code and you should see the values printed 
out in the Shell change when the motor is moved. 


Make your Pong screen 

Open a new file in Thonny and add the 
following code to import the Turtle, time, and Build 
HAT libraries, and then set up a screen. Run the file 
and you should see a black window with the title 
*PONG' open. 


from turtle import Screen, Turtle 
from time import sleep 
from buildhat import Motor 


game area = Screen() #Create a screen 

game area.title("PONG") #Give the screen a 
title 

game area.bgcolor('black') #Set the 
background colour 

game area.tracer(0) #Give smoother 
animations 


The Turtle library also has a useful way of setting 
the co-ordinates for a screen area. Add this line to 
your program: 


-200, 170 200, 170 


-200, -170 
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game area.tracer(0) 
game area.setworldcoordinates(-200, -170, 
200, 170) 


This creates a rectangular window 400 pixels 
wide and 340 high, with o being in the centre (see 
Figure 1). 

Now, you need to update your game area, to see 
the paddle and ball. Add a game loop to the bottom 
of your code, and call the update() method. 


while True: 
game area.update() 


Run your code and you should see a black window 
appear. Next, you can make a ball by using a Turtle 
that is set to be a white circle. The ball should start 
in the middle of the screen, and shouldn't draw a 
line when it moves. Above your while True: loop, 
add the following code: 


ball = Turtle() 
ball.color('white') 
ball.shape('circle') 
ball.penup() 
ball.setpos(0,0) 


while True 


Run your code again. You should see a white ball 
appear in your window. Next, you can set up a 
paddle in the same way. It will be a green rectangle, 
and positioned on the far left of the screen. 


paddle left - Turtle() 

paddle left.color('green') 
paddle left.shape('square') 
paddle left.shapesize(4, 1, 1) 
paddle left.penup() 

paddle left.setpos(-190, 0) 


Run your code and you should see your ball 
and paddle. 


Move the ball 

The ball is going to bounce around the 
screen, so two variables are needed to keep track of 
its speed in both the ‘x’ and ‘y’ directions. These 
numbers can be larger to make the game harder, or 
smaller to make the game easier. 


ball.speed x = 1 


ball.speed_y = 1 


You can check where a Turtle is by using 
turtle.xcor() and turtle.ycor() to find the ‘x’ 
and ‘y’ co-ordinates, respectively. So to make 
the ball move, you can combine the position and 
speed. Add the lines below to your program: 


while True: 
game area.update() 
ball.setx(ball.xcor() * ball.speed x) 
ball.sety(ball.ycor() * ball.speed y) 


Run the program and see what happens! The 
ball should move diagonally upwards towards 
the top right corner of the game area... and 
then keep on going! If you want your game to 
be fast and challenging, you can increase the 
speed x and speed y values to make the ball move 
more quickly. 
The ball should bounce off the top wall rather 
than disappear off the screen. To do this, the 
speed can be reversed, making the ball travel in 
the opposite direction, if its *y' position is greater 
than 160. 
Add the following code into your game loop and 
run it. 


while True: 
game area.update() 
ball.setx(ball.xcor() * ball.speed x) 
ball.sety(ball.ycor() * ball.speed y) 
if ball.ycor() » 160: 
ball.speed y *- -1 


Run your code again, and the ball should bounce off 


the top of the screen, but disappear off the right of 
the screen. 

In the same way that the code checks the upper 
‘y’ position of the ball, to make it bounce, it can 
check the right ‘x’ position and the lower ‘y’ 
position, in your game loop. 

Add these checks on the ball’s position. 


if ball.ycor() » 160: 
ball.speed y *- -1 

if ball.xcor() » 195: 
ball.speed x *- -1 

if ball.ycor() « -160: 
ball.speed y *- -1 


The ball should now bounce around the screen, 
and fly off the left edge. Next, you will control your 
paddle to reflect the ball back from the left edge. 


TUTORIAL | fMágPi ME 


A Connect a motor 
to port A on the 
Build HAT 


Control the paddle 
The LEGO Spike motor is going to be used 
to control the position of the paddle, but you don't 
want to be able to make full turns. 
A simple way to limit the motion of the wheel 
is to add a LEGO element to prevent the wheel 
turning through a complete rotation. 
Line up the encoder marks on your motor using 
the wheel, like before. Insert a peg or axle as close 
to level with the markers as possible. 


m The LEGO Spike motor is going to be used 
to control the position of the paddle Ei 


Add a line to create the motor left object after 
the import line. 


from buildhat import Motor 
motor left - Motor('A') 


Now a new variable is needed to keep track of the 
location of the paddle. This will be called pos. left 


and set to о. 
ball.speed x = 0.4 
ball.speed y - 0.4 


pos left - 0 


Create a function for the paddle that will run 
when the motor encoder moves. Note that it uses 
a global variable so that it can change the value of 
the pos left variable. 
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A Use pegs to 
attach the wheel 
to the motor 


def moved_left(motor_speed, motor_rpos, 
motor_apos): 
global pos_left 
pos_left = motor_apos 


Now add a single line that will use that function 
each time the motor is moved. It can be just before 
your while True: loop. 


motor left.when rotated - moved left 


Then, add aline to the while True: loop to update 
the paddle object on the screen to the new position. 


if ball.ycor() « -160: 
ball.speed y *- -1 
paddle left.sety(pos left) 


Run your code and then turn the wheel on your 
motor encoder. You should see your paddle moving 
up and down the screen. 

In case there are errors, your code should 
currently look like pong.py. 


07 Paddle collisions 

The game is nearly complete - but first you 
need to add some extra collision detection that 
covers the ball hitting the paddle. 

Within the while True: loop, check if the ball's 
‘x’ position is within the horizontal area covered 
by the paddle. Also use an and to check the balls 
‘y’ position is in the vertical line in which the 
paddle moves. 


paddle left.sety(pos left) 

if (ball.xcor() « -180 and ball.xcor() » 
-190) and (ball.ycor() « paddle left.ycor() 
* 20 and ball.ycor() » paddle left.ycor() - 


44 | magpicc | Make a Build HAT game controller 


20): 
ball.setx(-180) 
ball.speed x *- -1 


Try the program out. You should be able to bounce 
the ball off your paddle and play a solo game 
of ‘squash’! 

Now you have a way of preventing the ball from 
disappearing off-screen, it’s time to think about 
what happens if you fail to make a save. For now, 
let’s just reset the ball back to the start. 

Add this code within the while True: loop: 


ball.speed_x *= -1 

if ball.xcor() < -195: #Left 
ball.hideturtle() 
ball.goto(0,0) 
ball.showturtle() 


Once you're happy with the various settings, it's 
time to add in the second paddle. Using what 
you've created for the left-hand paddle as a 
starting point, add a second paddle on the right- 
hand side of the game area. 


m Once you're happy 
with the various 
settings, it's time to add 
in the second paddle Ø 


First of all, connect a second LEGO Technic 
motor to the Build HAT (port B) and set it up in 
the program. 


motor left - Motor('A') 
motor right - Motor('B') 


You can copy and paste your code for setting up 
your left paddle, and change the name and values 
for your right paddle. Create your right paddle. 


paddle left - Turtle() 
paddle left.color('green') 
paddle left.shape("square") 
paddle left.shapesize(4,1,1) 
paddle left.penup() 

paddle left.setpos(-190,0) 


paddle right - Turtle() 
paddle right.color('blue') 


paddle right.shape("square") 
paddle right.shapesize(4,1,1) 
paddle right.penup() 

paddle right.setpos(190,0) 


Add a variable for the right paddle position, a 
function for the paddle, and the line to call the 
function when the right motor is moved. 


pos left - 0 
pos right = @ 


def moved left(motor speed, motor rpos, 
motor apos): 
global pos left 
pos left - motor apos 


def moved right(motor speed, motor rpos, 
motor apos): 
global pos right 
pos right - motor apos 


motor left.when rotated - moved left 
motor right.when rotated = moved right 


Add a line to update the paddle on screen to the 
while True: loop: 


paddle left.sety(pos left) 
paddle right.sety(pos right) 


Currently, the ball will bounce off the right-hand 
wall. Modify the lines of your program that make 
that happen so that the ball is instead reset to the 
centre. Now add a similar condition for the right 
paddle as you did with the left, to handle collisions. 


A Aview of the game window with the score displayed at the top 
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pong.py 


DOWNLOAD 
THE FULL CODE: 


» Language: Python 3 


© magpi.cc/pongpy 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 
010. 
011. 
012. 
013. 
014. 
015. 
016. 
017. 
018. 
019. 
020. 
021. 
022. 
023. 
024. 
025. 
026. 
027. 
028. 
029. 
өзе. 
031. 
032. 
033. 
034. 
035. 
036. 
037. 
038. 
039. 
040. 
041. 
042. 
043. 
044. 
045. 
046. 
047. 


from turtle import * 
from time import sleep 
from buildhat import Motor 


motor left = Motor(' A') 


game area - Screen() 

game area.titlev' PONG’) 

game area.bgcolor('black') 

game area.tracer(0) 

game area.setworldcoordinates(-200, -170, 200,170) 


ball = Turtle() 


ball.color('white') 
ball.shape('circle') 


ball.penup() 


ball.setpos(0,0) 


paddle left - Turtle() 
paddle left.color(' green') 
paddle left.shape(' square") 
paddle left.shapesize(4,1,1) 
paddle left.penup() 

paddle left.setpos(-190,0) 


ball.speed x 
ball.speed y - 


pos left - 0 


0.4 
0.4 


def moved left(motor speed, motor rpos, motor apos): 
global pos left 
motor apos 


pos left - 


motor left.when rotated - moved left 


while True: 


game area.update() 
ball.setx(ball.xcor() + ball.speed x) 
ball.sety(ball.ycor() + ball.speed y) 
if ball.ycor() » 160: 

ball.speed y *- -1 
if ball.xcor() » 195: 

ball.speed x *- -1 
if ball.ycor() « -160: 

ball.speed y *- -1 
paddle left.sety(pos left) 
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Turtle Race 


Turtle is a drawing 
and animation 
library and you 
can learn more 
about it with the 
excellent Turtle 
Race projects. 
magpi.cc/ 
turtlerace 


WY Тһе rotating disc 
of the motor has a 
mark shaped like a 
lollipop, this can be 
lined up with the o 
mark on the white 
body of the motor. 
This is the encoder 
set to zero degrees 


~ 
ct 
К.) 


if (ball.xcor() < -180 and ball.xcor() 
> -190) and (ball.ycor() « paddle left.ycor() 
+ 20 and ball.ycor() > paddle left.ycor() - 
20): 
ball.setx(-180) 
ball.speed x *- -1 
if (ball.xcor() » 180 and ball.xcor() « 
190) and (ball.ycor() « paddle right.ycor() 
* 20 and ball.ycor() » paddle right.ycor() - 
20): 
ball.setx(180) 
ball.speed x *- -1 


You should now be able to enjoy a basic two-player 
game of Pong. Your code should currently look like 
two player basic.py. 


Improve your project 
There are a few additional features you can 
add to finish off your game. Keep track of the score 
by using two variables (one for each player) and 
update them whenever a round is lost. 
First of all, declare the new variables towards the 
top of the program and set the score to zero. 


| 
© 


score_r = 
ѕсоге 1 = ө 


Whenever a ball is missed, increment the 
appropriate score variable by one. There are two 
conditional tests you'll need to modify. 


if ball.xcor() > 195: #Right 
ball. hideturtle() 
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ball.goto(0,0) 
ball.showturtle() 
score_r+=1 
if ball.xcor() « -195: #Left 

ball.hideturtle() 
ball.goto(0,0) 
ball.showturtle() 

score l«-1 


Now you need to display the score in the game 
area. You can use a fourth Turtle to do this. Add 
the following to your program after the creation 
of the paddle and ball Turtles, but before the while 
True: loop. 


writer - Turtle() 

writer.hideturtle() 

writer.color('grey') 

writer.penup() 

style - ("Courier",30,'bold') 

writer.setposition(0,150) 

writer.write(f'(score 1) PONG (score г} ', 
font-style, align-'center') 


You can look at the documentation for the Turtle 
library to see what other options there are for how 
the text is displayed. 


m There are a few additional 
features you can add to 
finish off your game @ 


If you run your program now, the score and Pong 
legend should appear, but the scores themselves 
won't get updated. 

Find the two conditionals for each of the scoring 
situations - when the ball is missed by a paddle 
and disappears to the left or right - and update the 
score by rewriting the new value. 


writer.clear() 
writer.write(f'(score 1) PONG 
(score rj', font=style, align-'center') 


Adding a buzzer 
To include some simple sound effects, 
connect a buzzer to the GPIO pins on Raspberry Pi. 
Instead of using a breadboard, you could use 
jumper leads with female sockets at both ends 
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two_player_basic.py TRG 


» Language: Python 3 eo magpi.cc/twoplayerbasicpy 
001. from turtle import * 042. pos left - motor apos 

002. from time import sleep 043. 

003. from buildhat import Motor 044. def moved right(motor speed, motor rpos, 

004. motor apos): 

005. motor left = Motor('A') 045. global pos right 

006. motor right = Motor('B') 046. pos right - motor apos 

007. 047. 

008. game area - Screen() 048. motor left.when rotated = moved left 

009. game area.title( PONG') 049. motor right.when rotated - moved right 

010. game area.bgcolor( black ') 050. 

011. game area.tracer(0) 051. while True: 

012. Бате area.setworldcoordinates(-200,-170,200,170) 052. game area.update() 

013. 053. ball.setx(ball.xcor() + ball.speed x) 

014. ball = Turtle() 054. ball.sety(ball.ycor() + ball.speed y) 

015. ball.color( white') 055. if ball.ycor() » 160: 

016. ball.shape('circle') 056. ball.speed y *- -1 

017. ball.penup() 057. if ball.xcor() » 195: 

018. ball.setpos(0,0) 058. ball.hideturtle() 

019. 059. ball.goto(0,0) 

020. paddle left - Turtle() 060. ball.showturtle() 

021. paddle left.color('green') 061. if ball.ycor() « -160: 

022. paddle left.shape(' square") 062. ball.speed y *- -1 

023. paddle left.shapesize(4,1,1) 063. paddle left.sety(pos left) 

024. paddle left.penup() 064. paddle right.sety(pos right) 

025. paddle left.setpos(-190,0) 065. if (ball.xcor() « -180 and ball.xcor() » 
026. -190) and (ball.ycor() < paddle left.ycor() + 20 
027. paddle right - Turtle() and ball.ycor() » paddle left.ycor() - 20): 
028. paddle right.color( blue ') 066. ball.setx(-180) 

029. paddle right.shape(" square") 067. ball.speed x *= -1 

030. paddle right.shapesize(4,1,1) 068. if (ball.xcor() » 180 and ball.xcor() « 190) 
031. paddle right.penup() and (ball.ycor() « paddle right.ycor() + 20 and 
032. paddle right.setpos(190,0) ball.ycor() > paddle right.ycor() - 20): 

033. 069. ball.setx(180) 

034. ball.speed x - 0.4 070. ball.speed x *- -1 

035. ball.speed y - 0.4 071. if ball.xcor() « -195: # left 

036. 072. ball.hideturtle() 

037. pos left - 0 073. ball.goto(0,0) 

038. pos right = 0 074. ball.showturtle() 

039. 


040. def moved left(motor speed, motor_rpos, 
motor apos): 
041. global pos_left 
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P» Attach a peg 
to the rear of 
the wheel to 
prevent the wheel 
from spinning 
indefinitely 


and poke the legs of the buzzer into the socket. 
Then use some LEGO elements to mount the 
buzzer so that it doesn't flop around and become 
disconnected during frantic gaming sessions. 

Now add the gpiozero library to the list of 
imports at the start of your program: 


from gpiozero import Buzzer 


Then, make the buzzer available for the program to 
use, by setting which pin you have connected the 
positive (+) leg to. here, we used GPIO 17. 


buzz - Buzzer(17) 


If you didn’t use GPIO17, change the value to 
reflect the pin your buzzer is connected to. 
Now, whenever the paddle and ball make 
contact, you want the game to play a short tone. 
Add this line to each action part of the collision 
detection if conditionals for the ball and paddle: 


buzz.beep(0.1,0.1,background-True) 


Then add a line to play a longer tone whenever the 
player misses the ball. 


buzz.beep(0.5,0.5,background-True) 
You can read more about the options 


available with buzzers in the GPIO Zero 
documentation (magpi.cc/buzzer). 
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2 Add even more randomness 
to the speed and trajectory 
of the ball, and make the 
ball move faster Л 


Improve the Pong game 

Here are some ideas to improve your game 
of Pong. You can add even more randomness to the 
speed and trajectory of the ball, and make the ball 
move faster as the game progresses. 

Right now the game carries on forever - consider 
having a target score that a player must achieve 
in order to win and then start a new set of rounds; 
change the scoring method to count how many 
times the players return the ball to one another, 
and reset when someone misses. Or, introduce 
some haptic feedback, so that the motors turn a 
small amount when a point is lost. 

At the moment it doesn't matter what part of the 
paddle connects with the ball; it will always bounce 
off at the same angle as it hit. Modify the collision 
code so that the angle becomes more obtuse if the 
ball makes contact close to the end of the paddle. 

Create more games that use the LEGO Technic 
motors as controllers. 

How about a game in the style of Angry Birds, 
where two controllers are used to set the launch 
trajectory and the amount of force applied to 
the catapult? @ 
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Phil King 


Long-time 
contributor to The 
MagPi, Philis a 
freelance writer and 
editor with a focus 
on technology. 


@philkingeditor 


| You'll Need 


» DHT11 sensor 
magpi.cc/dht11 


» UV sensor 
magpi.cc/uvsensor 


» MCP3008 ADC 
magpi.cc/mcp3008 


» Jumper wires 


» Figure 1 The wiring 
diagram for the 
weather station, 
including the DHT11 
sensor, UV sensor, 
and ADC 


Explore the 
sensory world: 
Build a simple 
weather station 


Measure temperature, humidity, and UV light with this basic weather station 


couple of alarms: one for fire and gas 

safety, the other for detecting intruders. 
This time we're doing something a little different 
by using a couple of sensors to measure certain 
weather conditions: temperate, relative humidity, 
and ultraviolet light. One of the sensors gives an 
analogue output, so we'll learn how to convert 
that to a digital reading using an ADC. 


D reviously in this series, we have built a 


Connect DHT11 sensor 

The DHT11 sensor measures temperature 
and relative humidity. We're using one from the 
Waveshare Sensors Pack, available from The Pi Hut 
(magpi.cc/wavesensors), and also sold separately. 
You can buy a similar DHT11 sensor elsewhere, 
sometimes without the PCB, or you could upgrade 
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to a DHT22 or use a different sensor such as a 

BME280 (which also reads barometric pressure). 
The DHT11 combines a digital thermistor with 

a capacitive humidity sensor and outputs digital 

readings, so it's easy to use. With the power turned 

off, connect the DHT11 sensor to Raspberry Pi as 

in Figure 1. We're powering it from Raspberry Pi's 

3V3 pin, grounding it with a GND pin (both via 

the breadboard side rails), and the digital output 

(marked DOUT on the sensor) is going to GPIO14. 


Install DHT11 library 

With the DHT11 sensor wired up, turn on 
Raspberry Pi. You should see the sensor’s red 
power LED (on the right) light up. 

Since the DHT11 outputs its data in binary form 
to the GPIO14 pin, we'll need a way of converting 
that into decimal numbers. The easiest way is to 
use a ready-made Python library. We're using 
szazo’s DHT11 library, which can be installed with 
the following Terminal command: 


pip3 install dht11 


Temperature and humidity test 

To begin, we'll create a simple Python 
program (dht11_test.py), to read the sensor’s 
temperature and humidity outputs. From the 
desktop menu, go to Programming » Thonny IDE. 


The MCP3008 ADC 


converts analogue outputs 
to digital for Raspberry Pi 


As our DHT11 library uses the RPi.GPIO Python 
library, we import that as ‘GPIO’ at the top of the 
code. We then initialise the GPIO and do a standard 
clean-up to reset all pins to inputs. 

Within an infinite while True: loop, we read an 
instance of the GPIO 14 pin value. If the result is 
valid (i.e. not an error), we print the temperature 
and humidity values to the Shell. In our print 
statement, the 4-3.1f format parameter sets each 
output to a minimum three digits including one 
decimal place. We add the end = "\r\" parameter 
so the message is always printed on the same line. 

Run the dht11 test.py code and check that you 
are getting realistic readings. Try breathing on the 
sensor to increase both temperature and humidity. 


Add an ADC 

The Waveshare UV sensor (GUVA-S12SD) 
we're using outputs an analogue signal, so we'll 
need to convert that to a digital value using an ADC 
(analogue-to-digital converter). We're using the 
MCP3008 ADC, which has eight input channels. 

Since this chip uses the SPI interface, we'll need 

to enable SPI in the Raspberry Pi Configuration tool. 
It's also best to enable full SPI support in Python 3. 
To do so, open a Terminal window and enter: 


sudo apt-get install python3-spidev 


With the power to Raspberry Pi turned off, it's 
time to wire up the ADC. Place the MCP3008 in the 


и 


The DHT11 sensor measures 
both temperature and 
relative humidity 


The UV sensor detects 
ultraviolet light and has 
an analogue output 
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TopTip è 
Off board 


We've placed our 
DHT11 sensor on 
the breadboard, 
but you could 
wire it directly 

to Raspberry Pi's 
GPIO pins. 


dht11 test.py 


» Language: Python 3 


001. import RPi.GPIO as GPIO 
002. import dht11 

003. 

004. it intialise GPIO 

005. GPIO.setwarnings(False) 
006. GPIO.setmode(GPIO.BCM) 
007. GPIO.cleanup() 


008. 

009. while True: 

01e. instance = dht11.DHT11(pin = 14) 

011. result = instance.read() 

012. if result.is valid(): 

013. print(" Temperature: %-3.1f C" % result.temperature, 


"Humidity: %-3.17 %%" % result.humidity, епа = "\r") 


middle of the breadboard, straddling its central 
groove. Make sure it’s the correct way round, as 


shown in Figure 1, with the top of writing on top of 


the ADC nearest Raspberry Pi. 

Now connect the jumper wires as in Figure 1. 
Two of them go to the ‘+’ breadboard power rail, 
connected to a 3V3 pin; two others are connected 
to a GND pin via the ‘~’ rail. The four middle legs 
of the ADC are connected to the SPI interface 
on Raspberry Pi: GPIO pins 8 (CEO), 10 (MOSI), 9 
(MISO), and 11 (SCLK). 
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uv_test.py 


» Language: Python 3 


001. 
002. 
003. 


from gpiozero import MCP3008 
v - MCP3008(0) 


while True: 
print("UV: %-3.5f V" % (3.3 * uv.value), end = "\r") 


| uv index.py 


» Language: Python 3 


from gpiozero import MCP3008 
v = MCP3008(0) 


def uv range(): 


global uv mv 

global uv index 

uv mv - int(3300 * uv.value) 

if uv mv in range (0,227): 
uv index = @ 

elif uv mv in range(227,318): 
uv index - 1 

elif uv mv in range(318,408): 
uv index - 2 

elif uv mv in range(408,503): 
uv index - 3 

elif uv mv in range(503,606): 
uv index - 4 

elif uv mv in range(606,696): 
uv index - 5 

elif uv mv in range(696,795): 
uv index - 6 

elif uv mv in range(795,881): 
uv index - 7 

elif uv mv in range(881,976): 
uv index - 8 

elif uv mv in range(976,1079): 
uv index - 9 

elif uv mv in range(1079,1170): 
uv index - 10 

elif uv mv »- 1170: 
uv index - 11 


while True: 


uv. range() 
print("UV index: ",uv index, end = "\r") 
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Connect the UV sensor 

With the ADC wired up to Raspberry Pi, 
we can now add our UV sensor to the setup. As in 
Figure 1, we connect its VCC pin to 3.3V via the 
breadboard power rail, and its GND pin to GND on 
Raspberry Pi via the breadboard ground rail. 

Finally, we connect the sensor's AOUT (analogue 

out) pin to the MCP3008's channel 0 pin, as shown 
in Figure 1. You could wire it to any of the eight 
channels on that side, but we're using this one in 
our code. 


UV test 

Let's create a simple program to test the 
sensor. In the uv, test.py listing, this time we're 
using the GPIO Zero library as it has a handy 
MCP3008 class, which we import at the top. We 
assign the uv variable to the MCP3008's channel o 
to read the connected sensor's analogue output. 

Inawhile True: loop, we multiply the digitally 

converted sensor output (which ranges from 0 to 
1) by the 3.3 maximum voltage to get an accurate 
voltage reading. If you're indoors, it should be 
very low. To test it, you could move the sensor 
outside, or just hold it through an open window. 
Alternatively, you could try shining an ultraviolet 
light (such as from a counterfeit currency detector) 
onto it. You should see the output value change. 


07 UV index level 
We're getting an accurate voltage reading 

from our UV sensor, but what does it mean? We 
need to convert it to the international standard UV 
index for it to be useful. 

In the uv. index.py listing, we create a иу range 
function with a series of if and elif statements to 
check which range of values the reading (converted 
into microvolts in the uv. mv variable) falls into and 
then set the UV index level (uv. index) accordingly. 

Note: We've estimated the ranges for this based 
on a table of typical voltage values for each index 
that we found online for the sensor, but it may vary 
depending on temperature. 


Bringing it together 

Finally, let's combine the code with our 
earlier DHT11 program to read both sensors and 
print the appropriate weather information, in the 


A Testing the UV sensor with ultraviolet light. It needs 
to be of the correct wavelength to be sensed 


weather.py listing. We can use both the RPi.GPIO 
and GPIO Zero libraries (the latter is based on the 
former), but we need to initialise the GPIO pins 
before setting any GPIO Zero values. 

We include our uv_range function to determine 
the UV index and add a call to it in the while True: 
loop. We also add its output to the print function. 


Take it outside 

If you want to locate your weather-sensing 
project outside, you'll need a weatherproof case 
for the electronics. Alternatively, you could even 
house it in a couple of connected drainpipe bends, 
as we used for an air sensor project in The MagPi 
issue 92 (magpi.cc/92) - in which case, it's best to 
use a Raspberry Pi Zero W to save space. 

You'll need to power the project via an extended 
USB cable. Assuming you want to read the outputs 
from it remotely, via SSH or possibly a web 
dashboard, you'll also need to connect Raspberry 
Pi to your router - if doing so wirelessly, depending 
on the project's distance from the router, you may 
need a WiFi range extender. 


Taking it further 

We have made a very basic weather station. To 
improve it, you could add a barometric pressure 
sensor such as the BMP280 - or switch out the 
DHT11 for a BME280, which measures temperature, 
humidity, and pressure, but you'll need a different 
Python library for that. 

If locating it outdoors, you could also add special 
weather sensors such as an anemometer (wind 
speed), rain gauge, and wind vane, as featured 
in the SparkFun SEN-15901 Weather Meter Kit 
(magpi.cc/sfweatherkit). 

Next time we'll use moisture and liquid level 
sensors to monitor a plant. See you then. M 
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DOWNLOAD 
weather.py THE FULL CODE: 


» Language: Python 3 Ө magpi.cc/github 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 
010. 
011. 
012. 
013. 
014. 
015. 
016. 
017. 
018. 
019. 
020. 
021. 
022. 
023. 
024. 
025. 
026. 
027. 
028. 
029. 
030. 
031. 
032. 
033. 
034. 
035. 
036. 
037. 
038. 
039. 
040. 
041. 
042. 
043. 
044. 
045. 
046. 


import RPi.GPIO as GPIO 
import dht11 
from gpiozero import MCP3008 


it intialise GPIO 
GPIO.setwarnings(False) 
GPIO. setmode(GPIO.BCM) 
GPIO.cleanup() 


uv - MCP3008(0) 


def uv range(): 

global uv mv 

global uv index 

uv mv - int(3300 * uv.value) 

if uv mv in range (0,227): 
uv index = @ 

elif uv mv in range(227,318): 
uv index = 1 

elif uv mv in range(318,408): 
uv index - 2 

elif uv mv in range(408,503): 
uv index - 3 

elif uv mv in range(503,606): 
uv index = 4 

elif uv mv in range(606,696): 
uv index = 5 

elif uv mv in range(696,795): 
uv index - 6 

elif uv mv in range(795,881): 
uv index - 7 

elif uv mv in range(881,976): 
uv index - 8 

elif uv mv in range(976,1079): 
uv index - 9 

elif uv mv in range(1079,1170): 
uv index - 10 

elif uv mv »- 1170: 
uv index - 11 


while True: 

uv range() 

instance = dht11.DHT11(pin = 14) 

result = instance.read() 

if result.is valid(): 

print(" Temperature: X-3.1f C" % result.temperature, 

"Humidity: #-3.1Ғ 7%" % result.humidity, "UV index: ", 
uv index, end = "\r") 
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Composite video with 
Raspberry P1 Zero 2 W 


PJ Evans 


PJ is a writer, software 
engineer, and 
tinkerer. His ambient 
music collection has 
been described as 
“inspiring” (PJ Evans) 
and “just a load of 
random noise" (Mrs 
Evans, music teacher. 


twitter.com/ 
mrpjevans 


| You'll Need 


» Raspberry Pi 
Zero 2 W 
magpi.cc/zero2w 


» RCA male plug 
terminal block 
magpi.cc/rca 


> 30AWG 0.05 mm 
silicon wrapped 
wire (or similar) 
magpi.cc/30awg 


» TV or monitor with 
RCA composite 
video input (PAL 
or NTSC) 


Raspberry Pi Zero 2 W continues support for composite 
video out, making it a great candidate for retro projects. 
You'll have to get the soldering iron out, though 


incorporated some form of composite video 

output, from the RCA connector of the 
original to the integrated 3.5 mm video/audio jack 
of current models. The Zero range also supports 
composite out, but requires a little work on the 
owner's part. The latest Raspberry Pi Zero 2 W has 
access and you can get a signal. Composite is a great 
medium for retro projects, helping to recreate the 
authentic look of retro games. It's also handy for 
connectivity where HDMI isn't an option. Here we'll 
show you how to get that slightly fuzzy video feed. 


E very full-size model of Raspberry Pi has 


Choose and prepare your 

operating system 
We're sure you'll be interested in taking the all- 
new Bullseye release of Raspberry Pi OS with 
Desktop for a spin. However, have a think about 
the needs of your project. If you're interested in 
recreating the intended aesthetic of 1980s video 
games, check out RetroPie (retropie.org.uk) 
or, if you're driving an old TV showing vintage 
programmes, maybe Raspberry Pi OS Lite will save 
you precious resources as it can play video using 
OMXPlayer from the command line. We're going to 
go for the Desktop version. As ever, prepare your 
microSD card, and make sure everything is up-to- 
date before continuing using Software Update. 
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Find the pads 

On the original Raspberry Pi Zero, 
composite video access was via two through- 
hole soldering points; on Zero 2 W, access to the 
composite signal has been replaced with PCB test 
pads on the reverse of the board. These small, flat 
discs are normally intended for using logic probes 
to test parts of a PCB. However, they have been 
repurposed here for their space-saving properties. 
On the back of the PCB, look near the HDMI 
connector for a pad marked TV and one near it 
marked GND. We're going to solder on to these. 


wea 
0c-138 
94V-OH 


| 
1.9 
ive Him 


s antenna technology 0 
ensed from Proant А) 


Video Out (+) Ground (-) 


A These PCB test pads allow us to tap the composite 
video feed. Make sure you get the right ones! 


These wires connect to small 
‘test pads’, so a steady hand on 
the soldering iron is a must! 


Measure up 

Composite video is not what is termed 
a ‘balanced’ signal. It’s analogue in origin, not 
digital. What this boils down to is ‘the shorter the 
better’, as a composite video signal will degrade 
over distance. It’s also sensitive to external 
electrical interference. As we do not want to be 
resoldering on to the small pads in the future, be 
mindful of how much wiring you need (although 
always allow yourself a little bit more for mistakes). 
As we are using very thin wire in this project, you 
may also want to consider an additional sleeve or 
heat-shrink covering to protect the signal further. 


Prepare your wiring 

As the PCB pads are so small, we've opted 
for a 30AWG silicone-sleeved wire. This has two 
important properties. Firstly, the wire is very small, 
helping us to hit our target. Secondly, the silicone 
allows the wire to flex freely, so it is much less 
likely to snap off the pad through wear and tear, 
unlike nylon-covered wires. That said, if you don't 
have this type of wire, that's OK, but be careful with 
soldering and handling. Having worked out your 
optimum length, cut two equal length pieces of 
wire and strip the sleeve on all ends, as short as you 
dare on the PCB pad side, and enough on the other 
to fit the RCA screw terminals without poking out. 


We've chosen this screw-block RCA 
connector for simplicity, but you can 
solder one in place if you prefer 


Get soldering 

Take your time with this next step. Start 
by coating the ends of the two wires with a small 
amount of solder (‘tinning’ or ‘silvering’). Watch 
for any protrusions that could cause a short circuit 
and if the ends are too long, trim them with snips. 
Next, solder one wire to the TV pad and another to 
the GND pad (it's common to use a black sleeved 
wire for GND). We recommend carefully mounting 
the Raspberry Pi Zero 2 in a PCB holder or ‘helping 
hands’, and holding the wire in place with some 
masking tape. 


Tidy up and wire up 

As gently as possible, secure the wire close 
to the solder points so that any inadvertent pull on 
the wire will not cause it to snap. You could usea 
piece of sticky tape or a dab of hot glue. Now, if you 
wish, you can carefully twist the two wires together 
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Alert! 


Although not part of 
this project. opening 
up a CRT television is 
very dangerous, risking 
electric shock. Be careful 
if you consider putting a 
Zero 2 W inside a CRT. 


magpi.cc/crt 


What about 
audio? 


The Raspberry 
Pi Zero 2 W does 
not have audio 
out (except for 
HDMI), so if you 
need analogue 
audio too, try an 
inexpensive USB 
sound adapter. 


Warning! 
Hot solder 


Soldering irons get very 
hot, and stay hot for a 
long time after they're 

unplugged. Read up 
on soldering before 
connecting the wires. 


magpi.cc/soldering 
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Use tape or tack 

to steady the wires 
before soldering, and 
make sure the PCB 
cant move about 


so they don't flap about. If you're adding additional 
shielding, this is the time to do it. Finally, connect 
the other ends of the wires to the terminal block. 
The wire from GND goes to the negative (-) 
terminal and the other wire to positive (+). 


Configure Raspberry Pi OS 
Before we can display the Raspberry Pi OS 
desktop over a composite connection, we need to 


tell the operating system that is what we would like 
to do. Connect up to a HDMI monitor and boot up 
(or SSH in). Open a Terminal window and run: 


sudo raspi-config 


Go to Advanced, then Composite, and select 
‘Enable’. Go back through the menus to exit. When 
asked if you want to reboot, select ‘No’ and shut 
down the operating system. Now, connect your 
composite cable to the TV/monitor, select the 
correct input source, and boot up. You should get 
video output right away. 


Screen adjustments 

If you are used to a ‘regular’ monitor, you 
may be surprised to find your Raspberry Pi OS 
desktop has significantly less real estate than 
before. Composite output is at a fixed resolution of 
720 * 576 pixels (PAL signal) and cannot be 
changed. Also, don’t expect comparable image 
quality, as composite video is an analogue signal, 
unlike digital HDMI. If you find the image is too big 
and disappearing off the edge of the physical 
screen, have a look at your TV’s settings: some have 
а zoom or overscan feature that can cause this. 


pi@rca: ~ 


Top Tip 


Raspberry Pi Software Configuration Tool (raspi-config? 


Al Expand Filesystem Ensures that all of the SD card is available 


Pogo pins A2 GL Driver Enable/disable experimental desktop GL driver 
АЗ Compositor Enable/disable xcompmgr composition manager 
If you don't A4 Network Interface Names Enable^disable predictable network i^f names 


AS Network Proxy Settings Configure network proxy settings 
Enable/disable gl raphics acceleration 


fancy soldering 
directly onto your 
Raspberry Pi Zero 
2 W, investigate 
pogo pins: 
spring-loaded 
pins designed to 
connect to PCB 
test pads. 


Enable/disable composite video output 


«Select? 


Before we can use 
composite video, it has 
to be enabled using 
raspi-config 
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Troubleshooting 

No video? Here are some things to try. 
First, ensure that you have soldered to the 
correct pads. The positive pad is marked TV 
with the label to the right of the pad. The pad 
to the left of GND is your ground wire. It’s very 
cramped on the PCB and this can be confusing. 
Also double-check you’ ve wired GND to the 
negative (outer part) of the RCA connector. 
Make sure your TV is on the correct input. If 
the video quality is unacceptable, shorten the 
wiring or move your Raspberry Pi Zero 2 W 
closer to the TV. 


Try out a retro game! 

We've now covered the how of a 
composite video output, so let's look at the 
why. There is lots we can do with composite, 
especially in terms of easy compatibility, and 
one of the most fun is retro gaming. Although 
we can run old games using HDMI, this level 
of sharpness was never intended by the 1980s 
graphics designers, who used all kinds of tricks 
to use the ‘fuzziness’ of a composite signal to 
their advantage. The result of using composite 
video is a much more faithful representation of 
the artists’ work. Check out RetroPie and Lakka, 
both great gaming platforms. 


On old TVs 

Fora true retro experience, try out our 
Raspberry Pi Zero 2 W modification using an 
original CRT TV. Most will accept the composite 
video input using an RCA jack like ours, but 
some will have a SCART connector. Adapters to 
make these work are cheap and readily available. 
Although new CRT-based TVs are almost 
impossible to find these days, there are plenty 
of second-hand sets available. Just always be 
extra-careful with second-hand electronics. If 
you have a plan to place the Zero 2 W inside the 
TV, please read up on the dangers of opening up 
a CRT set - or, better still, don't do it at all. 


Over to you 

Raspberry Pi Zero 2 W is an astonishingly 
powerful device for its price and size. At speeds 
that rival even Raspberry Pi 3 and its siblings, 
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A We used an RCA plug 
in our project, but you 
could use a socket with 
a connecting 
lead instead 


to be able to secrete one of these devices away and 
produce old-school video output is fuel for the 
imagination. Rather than add to landfill with that 
old TV set, why not create a random vintage TV 
show player using YouTube? Or, upcycle a broken 
games console for retro gaming how it should be. 
You could even add a Raspberry Pi Camera and add 
the setup to a low-cost CCTV system. As ever, it’s 
over to you. Ll 


A Here's the result on 
a LCD monitor. This 


screen overscans the 
image, so we've lost 
a bit of the desktop. 
Most will allow you to 
adjust this 
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with Raspberry P1 Zero 2 W 


Part art installation, part mathematical curiosity, this clock 
uses blocks of light to display the time as ones and zeroes 


very 1960s sci-fi movie computer was awash Hack the hardware 
with blinking lights, yet here we are - living Raspberry Pi Zero 2 W lacks the physical 
in the future - and they're nowhere to interface required to communicate with the Scroll 
be seen. Unless you have a binary clock. Rather pHAT HD panel, so your first job is to solder a 
than using hands or digits, our Raspberry Pi Zero 40-pin male GPIO header. The Scroll pHAT HD 
2 W-based timepiece opts for LEDs, illuminating is supplied with a female header, which you'll 
them to indicate the ones and zeroes (pun also need to solder to the pHAT. Once they've 
: : coincidental) with which it tells the time. It takes both attached to their respective boards, press 
Nik Rawlinson a bit of practice to get used to reading the time this them together to make the connection. We've 
way, but you'll soon become proficient at adding used Pimoroni's GPIO Hammer Header kit. The 
S cnr pergit the value of each column. In the meantime, just Male + Female + Installation Jig option (57/510, 
wielding, single- enjoy the hypnotic display. magpi.cc/hammerheader) contains all you need, 
board computing 
fan who likes 
hyphens and 
remembers what Hours appear on the top 


that icon on the 
save button depicts. 


two lines, and minutes 


on the two lines below 


You'll Need 


Scroll pHAT HD 
magpi.cc/ 
scrollphathd 


PHAT Diffuser 
тр Seconds are shown on the 
phatdiffuser bottom line, but are easily 
Male 40-pin removed if distracting 
HAT Header or 
Hammer Header 
magpi.cc/header 
magpi.cc/ 
hammerheader 
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A If you're using a Raspberry Pi without integral GPIO pins, you'll 
need to add your own 


aside from the hammer, and is easier and quicker 
than soldering. 


Attach the diffuser 

Because the ‘digits’ on our clock will be 
rendered in binary, they'll be composed of zeroes 
and ones. To indicate this, we'll dimly illuminate a 
block of LEDs for each zero, and brightly illuminate 
the blocks that represent a one. To maximise the 
contrast, we'll set the bright LEDs to shine at 10096, 
but the dim ones at just 2096, and use a diffuser 
to soften them. This not only gives the project 
an attractive bokeh feel, but makes the brightest 
LEDs less harsh. Use the screws supplied with the 
diffuser to attach it to the Scroll pHAT HD, with two 
nuts on each screw between the diffuser and the 
panel to maximise the spread. 


Enable the interface 

Every Raspberry Pi, including Raspberry Pi 
Zero 2 W, sports the I2C multi-device bus, which is 
used to communicate with attached peripherals like 
the LED panel that we're using to display the time 
on our clock. Go to Menu > Preferences > Raspberry 
Pi Configuration, choose the Interfaces tab, and 
set I2C to Enabled. Set SSH to Enabled and you'll 
be able to access the clock remotely from another 
computer with SSH with: 


ssh pi@<IP> 
...feplacing «IP» with the IP address of your 


Raspberry Pi (hover the mouse over your network 
icon in the menu bar to reveal it). 


Install the libraries 

Although Raspberry Pi OS has Python built 
in, it doesn't include the libraries required to 
address the Scroll pHAT HD. You'll need to install 


these at the command prompt. In a Terminal 
window on Raspberry Pi, or remotely if connected 
via SSH, type: 


curl https://get.pimoroni.com/scrollphathd 
| bash 


Press ENTER. Follow the prompts to install the 
libraries and included examples, which are worth 
examining in a code editor like Thonny, to get a 
better idea of the pHAT's full potential. 


Write the code 

Either use Thonny to type in the code from 
the binary.py listing here or download it from 
GitHub. Save it as binary.py in your user folder. 
Before we run it for the first time, we'll explain how 
it works. The first line: 


# !/bin/python3 


...tells the operating system where to find the 
Python interpreter, and the three lines that follow, 
each of which is preceded by ‘import’, call the 
libraries that the code uses to calculate and render 
the time. These are immediately followed by a 

line that informs the user that the binary clock is 
running, and how they can quit it. This will only 
appear if the routine is called at the command 
prompt. We'll be invoking it using cron so, in most 
cases, this won't be seen. 


A We've added a diffusion layer 
to soften the glow of the 
brightest LEDs and help them 
work as blocks, rather than the 
individual lights seen here 
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Warning! 


High temperatures 


If you solder the GPIO 
header, take care with 
the high-temperature 
soldering iron and flux. 


magpi.cc/soldering 


Seconds best 


If you find the 
updating seconds 
distracting, delete 
lines 34 to 40 

and adjust the 
hour and minute 
block heights 

to fill the gap. 
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A To read the time, 


add up the brighter 
columns, which are 
worth 32, 16, 8, 4, 2. 
and 1. Here, the clock 
shows 11:28am (and 
25 seconds) 


TopTip è 


Using this in 
a bedroom? 


Reduce the 
brightness values 
on lines 17, 25 and 
33. A setting of 

0.0 is off, and 1.0 
is full brightness. 
Choose something 
between. 


Start a loop 


We now begin a never-ending loop with: 
while True: 


Everything below this is indented because it’s 

part of the loop. Further indents within it signify 
embedded loops, each of which ends when the code 
moves back to the left. The first thing we do inside 
our loop is to get the current time, with: 


now = datetime.datetime.now() 


This stores the year, month, date, hour, minute, 
second, and millisecond in the now variable, which 
is far more detailed than we need - and in the 
wrong format. So, we'll extract and convert the 
components we need. 


Strip out the surplus characters 

To remove the ‘ob’ characters we add [2:] 
to the bin(now. hour) function, which instructs the 
interpreter to slice out the first two characters. 
Finally, because we need our time read-out to be 
right-aligned, so that it always counts from the ‘1’ 
column on our binary display, we add .zfill(6), 
which pads out the result by adding sufficient 
Zeroes to the start to make it exactly six digits 
long. The result, if it was 6pm (1800 hours), would 
therefore be 010010. And for 6am (0600 hours) it 
would be 000110. We repeat this for the minute 
(bmin) and second (bsec) readings. 59 minutes or 
seconds would become 11101. 


m The first thing we do 
inside our loop is to get 
the current time Л 


Understand the layout 

The Scroll pHAT HD has 17 columns and 
seven rows of LEDs. We'll use these to create six 
2x2 blocks of LEDs to represent the hours, six of 
the same, below, to represent minutes, and six 2x1 
blocks for seconds on the bottom row. The rows 
are numbered from zero to six, and the columns 
from zero to 16, which we need to bear in mind 
when telling the panel where to position the upper 
left corner of each block. The line of code on which 
we specify this will also define the block's width, 
height, and brightness. 


07 Extract the binary variables 
The next three lines define three variables 

for hour (bhour), minute (bmin) and second (bsec). 
We've preceded each with a ‘b’ to signify to 
ourselves that they're binary. Examining the bhour 
line in more detail, we're first extracting the hour 
from the time stamp stored in the now variable with 
now. hour, then converting it to binary by making 
it an input for the binary conversion function, 
like this: 


bin(now.hour) 


Unfortunately, this doesn't quite give us the 
answer we're after as the function adds two extra 
characters to the front of the result ‘ob’ to signify 
that the string is binary, rather than decimal. 


60 | magpicc | Make a binary clock with Raspberry Pi Zero 2 W 


Build your blocks 

We now define a new variable called pos, 
to represent the column position as we arrange 
the illuminated blocks, then create new loops 
for the hours, minutes and numbers. Each loop 
breaks the six binary digits of each number down 
into their individual ones and zeroes, so will cycle 
through six times apiece. In each cycle, they 
examine the relevant digit and, if it’s a zero, set 
a brightness variable to 20% (0.2) or, if it's a one, 
to 10096 (1.0). It then creates a block in memory 
using the scrollphathd.fill command, which 
combines the brightness, value of pos (column), the 
row, and the width and height of the block (2x2). 
The pos variable is then incremented by three, 
and the process repeats for the next digit in the 
binary value. 
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' DOWNLOAD 
binary.py THE FULL CODE: 


» Language: Python © magpi.cc/binclock 


001. # !/bin/python3 
002. 

003. import datetime 
004. import time 

005. import scrollphathd 
006. 


A If you only want to display hours and minutes, you could 


increase the height of those blocks to three rows, as 007. print('Binary clock is running. Press ctrl-c to stop.') 
we've done here 


008. 
009. while True: 

Output the time 010. now = datetime.datetime.now() 

By the time the routine has cycled through 011. bhour = bin(now.hour)[2:].zfill(6) 
the three loops for hour, minute, and second, 18 012. bmin - bin(now.minute)[2:].zfill(6) 
individual blocks of light will have been defined 013. bsec - bin(now.second)[2:].zfill(6) 
but, so far, they only exist in memory. To send 014. pos - 0 
them to the pHAT, we use the command: 015. 

016. for x in bhour: 
scrollphathd.show() 017. if x == '@': 
018. bright - 0.2 
This tells Python to output the buffer to the Scroll 019. е15е: 
pHAT HD. Finally, we pause for a second with: 020. bright = 1.0 
021. scrollphathd.fill(bright,x-pos,y-0,width-2,height-2) 
time.sleep(1) 022. pos = pos + 3 
023. pos = 0 
And then the overall loop begins again, to update 024. 
the time so it's correct for the next second. 025. for x in bmin: 
026. if x == '@': 
027. bright - 0.2 

Launch at boot 028. else: 

You can run the routine from the command 029. bright = 1.0 
prompt by navigating to your user folder and typing 030. scrollphathd.fill(bright,x=pos,y=3,width=2,height=2) 
python3 binary.py. However, we want this routine 031. pos = pos + 3 
to launch at boot so that as soon as the computer is 032. pos = ð 
plugged in, it starts working as a clock. Type: 033. 

034. for x in bsec: 
crontab -e 035. if x == '@': 
036. bright = 0.2 
If you've never edited crontab before, you'll be 037. else: 
asked which editor you want to use. Select Nano 038. bright = 1.0 
(option 1). Key down to a blank line at the bottom of 039. scrollphathd.fill(bright,x=pos,y=6,width=2,height=1) 
the file and type: 040. pos = pos + 3 
041. 
@reboot python3 /home/pi/binary.py & 042. scrollphathd.show() 
043. time.sleep(1) 


Press CTRL+X, press Y to save, then reboot. i 
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Rob Miles 


W @robmiles 


Rob Miles has been 
playing with hardware 
and software since 
almost before there was 
hardware and software. 
You can find out more 
about his so-called life at 
robmiles.com. 


ake a portable MIDI controller that 
you can use to create complex 
rhythms and musical sequences 
and use as a tiny keyboard. In 
a cheese box. The article ‘Make 
Music with Pico’, in HackSpace 
magazine issue 46, showed how easy it is to use 
a Raspberry Pi Pico device to send MIDI notes to a 
synthesizer. We are going to build on that to create 
a MIDI instrument, the ‘Pico musical cheese box’, 
as shown in Figure 1. The musical cheese box uses 
a ring of twelve pixels to display notes, and twelve 
buttons for user input. You can use the cheese box 
with a synthesizer program that connects to MIDI, and 
there is also a specially written Pure Data patch for it. 
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Figure1 © 

The white buttons are 
used to play notes, 
the coloured buttons 
are used to move 
between tracks. The 
cheese was delicious! 


Make a Pico musical 
cheese box 


Create syncopated rhythms and computer-generated music using a Pico 


INSIDE THE BOX 

Figure 2 shows the contents of the box. There are 
quite a lot of wires, but the task of assembly wasn't 
too onerous. The box contains a twelve NeoPixel 
ring and twelve buttons which are connected 

to a Raspberry Pi Pico. Each button has its own 
dedicated input pin on the Pico. 

Figure 3 shows the circuit for the box. The button 
signals are pulled low when a button is pressed. To 
simplify the wiring, the ground signal is connected 
in a ring around the switches. The pixel ring display 
only needs a single data connection, along with 
power and ground connections. 

The prototype used wire wrap wire for the 
connections. One end was wrapped round pins on 


the Pico device, the other end was hooked inside 
the hole in the pin on the switch, and then soldered 
in place as shown in Figure 4. All the switch 
connections were encased in heat-shrink tubing. 


HARDWARE MAPPING 

The buttons are used by the CircuitPython program 
running inside the Pico that controls the device. 
The program contains Note and Select classes to 
represent the two types of button on the device. 
Note and Select objects are created with hardware 
pins and pixel number settings when the box starts. 


notes = ( 

Note(pin-board.GP6,pixel-11,num-0), 
Note(pin-board.GP5,pixel-10,num-1), 
Note(pin-board.GP4,pixel-9,num-2), 
Note(pin-board.GP3,pixel-8,num-3), 
Note(pin-board.GP2,pixel-7,num-4), 
Note(pin-board.GP1,pixel-6,num-5), 
Note(pin-board.GP12,pixel-5,num-6), 
Note(pin-board.GP11,pixel-4,num-7) 
) 


selects - ( 
Select(pin-board.GP7,pixel-0,col-Col.RED), 
Select(pin-board.GP8,pixel-1,col-Col.GREEN), 
Select(pin-board.GP9,pixel-2,col-Col.BLUE), 
Select(pin-board.GP10,pixel-3,col-Col.YELLOW) 
) 


The code above is the Python that creates the 

collections of Note and Select objects that provide 
the user interface for the box. The note values are 
assigned a pin, a pixel number, and a note number 


You can use the 


cheese box with a 
synthesizer program that — 
connects to MIDI n" 


which will be used with they are played. The select 
values are assigned a pin, a pixel number, and the 
colour of the button which will be used to select 
the appropriate voice. This colour is then mapped 
to an instance of the appropriate Voice class. The 
mappings opposite were used for the first cheese 
box. You can change them to match the hardware 
that you build. Look for the statements in the 
program (they are near the bottom), and change the 
GP and pixel values to match your hardware. 


BOX SOFTWARE 
You can download the software for the box from the 
GitHub site for this project: hsmag.cc/CheeseBox. 
The software is written in CircuitPython, which can 
be installed on your Raspberry Pi Pico using the 
image from here: circuitpython.org/downloads. 
The software uses the Adafruit adafruit bus device 
and adafruit midi libraries, which need to be 
copied into the lib folder on the CircuitPython 
drive of your Pico. You can find these here: 
circuitpython.org/libraries. 

You can use Thonny (thonny.org) or Mu 
(hsmag.cc/MukEditor) on your computer to open the 
program and download it into your Pico. > 
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Figure 2 Ф 

The cables have been 
organised in two sets 
of six coloured wires 
(a red set and a green 
set), plus three (the 
yellow set) for the 
pixel. And there are 
still plenty of spare 
pins for more buttons 


YOU'LL NEED 


© ARaspberryPi 
Pico 


Ф A12-pixel WS2812 
pixel ring (search 
for WS2812 ring 12’) 


Ф 12 х coloured 
push-buttons 
Ideally eight white 
buttons for the 
notes and а red, 
green, blue, and 
yellow button for 
the controls. The 
buttons should be 
non-locking, push 
to make 


Ф Amicro USB 
cable to link the 
Pico to the host 


© Connecting wire 
The author used 
coloured wire wrap 
(search for ‘30 AWG 
wire wrap’) which 
needed a wire wrap 
tool (search for ‘wire 
wrap tool’). He also 
used a fair amount of 
heat-shrink tubing 


©  ARaspberry Pi or 
machine running 
Windows, macOS, 
or Linux running 
Pure Data to make 
the sounds 


Ф AboxThereisa 
3D-printable design, 
or you can just drill 
some holes for the 
lights and buttons 
in a cheese box and 
stick the pixel ring 
and Pico inside it 


Ф Screws You'll need 
some screws size 
M24 mm in length 
to fix the pixel ring 
and Pico to the 
case (search for 
"laptop screws") 
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т 


Figure 3 $ 

This diagram took 
almost as long to 
draw as it took to 
build the hardware 


Figure 4 4 

Wire wrap cable is 
single core, which 
makes it very easy to 
work with. It is also 
very flexible, so it is 
less likely to strain 
the connections at 
each end 


Different elements in the application are 


managed by software objects called classes 
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L3 
White N8 


A full description of how the program works 

would take more space than we have for this article, 
but we can take a look at how it is structured. 
Figure 5 shows a simplified class diagram for the 
software. Different elements in the application 

are managed by software objects called classes. 
The Button classes (Note and Select) manage the 
information for the buttons. The Voice classes 
(Keyboard and Rhythm) manage the information for 
the voice tracks that are played. The Setting class 
holds setting information for a collection of setting 
values. The Step class is based on the Setting class 
and holds information for a step in a track. The 
MidiBox class contains lists of buttons and voices, 
and repeatedly updates them to keep the box 
running and provide the illusion of several things 
happening at the same time. 


MAKING TRACKS 

The software manages four performance tracks: one 
keyboard track and three rhythm tracks. A track is 
selected by pressing one of the coloured buttons. 
When a track is selected, the pixel next to its 
selection button is lit in the colour of the button. The 
red keyboard track lets you play notes. When this 
track is selected (indicated by a red pixel next to the 
red button), the box starts a MIDI note playing when 


pin 


pixel values 


LN 
um zn 


value 


handler 


midi 


buttons 


settings active 


notes 


sounds 


a white note button is pressed and stops the note 
when the button is released. 

When a rhythm track is selected (by pressing a 
green, blue, or yellow button), the box will display 
the steps in the track and a moving white cursor that 
shows the position in the track. The user can select 
beats to be played at points in the track sequence 
by pressing the corresponding white button. All 
the sequencers run in parallel and work through 
a sequence of up to eight steps. Each step can 
produce a drum sound or a musical note. The speed 
of each sequencer can be changed, as can the 
length of sequence for that track. By making tracks 
of different lengths running at different speeds, you 
can create surprisingly complex rhythms as tracks go 
in and out of time with each other. 


Tune Track 


Rhythm Track 


press white buttons 
to select beats 


press white buttons 
to play notes 


settings 
аѕ пое j= SaFrt_sequenc 


no of notes pressed 


start all sequence 


Figure 6 shows how the buttons work for the 
tune and rhythm tracks. When the red track is 
selected, you can play notes just by pressing white 
buttons. When the green, blue, or yellow track is 
selected, you use the white buttons to set steps in 
the sequence. The green rhythm track on the right 
of Figure 6 starts with two beats from the kick drum 
(the red pixels) and ends with a ride cymbal (the 
yellow pixel). 

The rhythm track functions in the same way for 
all three tracks. You can step through the options for 
each step by repeatedly pressing the white button 
о change the colour of the pixel for that step. A 
red step means 'kick drum'. When the sequencer 
reaches that step, it will send a MIDI note to play 
hat sound. 

Figure 7 shows the mapping of pixel colours 
o drum sounds. The number after each sound 
name is the MIDI note that will be sent to trigger 
hat sound. These notes correspond to the 
General MIDI standard for musical instruments 
(hsmag.cc/MIDI) so the cheese box will work with 
most synthesizers. > 


A NOTE ABOUT SCALES 


The white buttons on the box don't play successive 
MIDI note values. Instead, they play the notes from a 
particular musical scale. This is so that the box sounds 
musical when you play it. Different scales use different 
arrangements of gaps between the successive notes. 
The most common scale is the ‘major’ scale, but there 
are others. Some have fantastic names like ‘Phrygian’ 
and 'Mixolydian', as you can see in the Scale setting in 
Figure 8. You can experiment with different scales to 
find the one that sounds best for a particular tune. 
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Figure 5 Ф 

A child class (one with 
an arrow pointing 

to the class above 

it) inherits all of the 
properties of the 
parent above it. The 
items inside each 
class are the data 
values stored within it 


Figure 6 

The two diagrams 
show the switches 
around the outside 
and the pixels in 
the middle 


[MAKE BUILD HACK CREATE 


Space 


HackSpace 


This tutorial is from 
HackSpace magazine. 
Each issue includes a 
huge variety of maker 
projects inside and 
outside of the sphere 
of Raspberry Pi, and 
also has amazing 
tutorials. Find out 
more at hsmag.cc. 
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Drums 
Off Kick 36 Snare 40 | Tomtom 48 | Ride 59 
[ SETTING UP 
Figure 7 Ф You adjust the settings for the box by holding down 


Each time you press 
a step button, the 
selected beat for 
that step moves to 
the next colour. If it 
reaches the end, it 
wraps around to 

off (black) 


the button for the selected track, and then setting 
the colour of pixels that are mapped onto setting 
values. If you press the red button when the red 
track is selected, the tune settings are displayed. 
Figure 8 shows the tune settings. There are 
seven different setting items. Each of them is 


assigned a pixel and 
п 


the value of the setting 


Figure 8 4 

The pixel colours 
in the centre of the 
settings show 

the default 

setting options 


selected by stepping 
through the colours for 
that setting. There are 
also seven settings for 
the rhythm track... 
Figure 9 shows the 
rhythm settings for the 
green track. You can set 
the speed of the track in beats per minute. You can 
also set the pattern length and the ‘speed factor’. 
The speed factor is used to slow down a rhythm 
track. A factor of 1 means normal speed. A factor of 
2 means half speed, a factor of 3 a third speed, and 


Tune Settings 


You can use the cheese box 
with any synthesizer, but you 
can also use it with a specially 

written Pure Data patch 


Splash 55 Clap 39 | Cowbell 56 


So on. You can also change the mode of a rhythm 
track to play notes rather than drums. This lets the 
track play short musical sequences. 


MAKING SOUNDS WITH PURE DATA 

You can use the cheese box with any synthesizer, 
but you can also use it with a specially written Pure 
Data patch. Pure Data is a programming language 
for creating music 
applications. You can 
find out more about it in 
the article in issue 47 of 
HackSpace magazine. 
Pure Data programs are 
expressed as a network 
of connected objects. 
The connections 
between the objects can 
be either individual values or audio streams. 

Figure 10 shows the Pure Data patch that 
generates sound output for the cheese box. It works 
as a 'switching station' which acts on incoming 
MIDI messages. The 'notein' object at the top left 
of the patch accepts incoming MIDI messages and 
sends out the note number, volume, and channel 
(these are the three outputs along the bottom of the 
notein object). The patch uses spigot objects 
to control the flow of the data around the 
patch. Values will pass through the spigot 
if the right-hand input to the spigot 

is true. 
Any messages sent to MIDI 


" 


Rhythm channel number 1 are passed into 
mmm — the polyphonic object (poly) and 
Off On 
Midi Channel 
Volume 
NN a 
1 2 3 4 
30 80 120 = i‘ (Dm 
5 6 7 8 
Scale Key sharp/flat 
Majer Minor Dorian Рһгудіап Natural Sharp Flat 
Lydian Mixolydian Lorian 
Octave Key 
C2 C3 C4 C5 E E 
G B 
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CHEESE BOX 


If you don't fancy 
buying some cheese 
justto get a box for 
your cheese box, you 
can download and 
3D-print a custom 
case. The designs 

are available at 

the GitHub site for 
this project: 
hsmag.cc/CheeseBox 


then on to a set of six note synthesizers. Messages 
sent to any other MIDI channel are stripped of 
their note off elements (these have no meaning for 
drums) using the stripnote object and then the note 
number is used to select the sound generator to be 
used. You will notice that the note numbers in the 
select object are the same as those in Figure 7. 
You can find this patch, along with installation 
instructions, at the GitHub site for this project: 
hsmag.cc/CheeseBox. At the moment, the note 
generators only output simple sine waves, but in 
the next issue of HackSpace magazine, we will be 
discovering how to use Pure Data to produce more 
interesting sounds and create a crackers controller 
to go with the cheese. 


Rhythm Settings 


Rhythm 


= 70 


Volume 
ишы и 
30 80 120 


Speed (bpm) 


60 80 100 
120 140 160 


Pattern Length 
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Pure Data patch for the PICO MIDI 
Cheesebox 


Notes to channel 1 are sent to a note 
synthesizer which is 6 note polyphonic. 


Notes to other channels are used for 
rhythms. The note value is used to select 
the sound generator. 


All the sound generators throw 
their output here to be 
converted into an audio signal 


EUCLIDEAN FUN 
By changing the speeds of the tracks and playing 
notes and drums at different points, you can 
generate interesting sounds that change over time. 
These are called Euclidean rhythms. You can find 
out more here: hsmag.cc/Euclidean. Don't be 
afraid to experiment with the sounds. If you change 
the rhythm mode of a track to 'Euclidian', the 
cheese box calculates a note frequency by adding 
together note values from other Euclidian tracks. 
By careful choice of track speeds, you can create 
extended sequences of changing notes. Once you 
have something interesting, try changing the scale 
and listen to what happens. You can 
pick different octaves for the note 
playback so you can generate 
bass sounds too. Remember 
that there is no such thing 
as bad music, just stuff 
that only you like. O 


Figure 10 Ф 

Pure Data programs 
can run on a huge 
range of computers, 
from Raspberry Pi 
Zero upwards 
Rhythm Mode Figure 9 @ 
By default, each 
rhythm track sends 
on a different MIDI 
channel so that the 
rhythms can be used 
to trigger different 
voices. However, you 
8 can select the MIDI 
channel for each track 
so that you can make 


Drums Notes Euclid 


Midi Channel 


1 2 3 4 
Шш ни 
5 6 7 


Speed factor 


2 3 4 the rhythm tracks play 
ШШ ни on the same channel 
5 6 7 


as the keyboard 
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No-emulation gaming direct on 
Raspberry Р1. By Rob Zwetsloot 


Pi that makes it really, painfully easy to get retro 

gaming working on a Raspberry Pi. However, did 
you know that some games run on Raspberry Pi OS without 
any form of emulation? And we don’t just mean Doom. 

Raspberry Pi is a computer after all, which means you 

can easily make games for it - we've done it several times 
ourselves with Python and Scratch. There are many games 
that have been released on or ported to Raspberry Pi, and we 
think it’s about time we show you some. 


Ш е love RetroPie. It’s a fantastic OS for Raspberry 
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Stream games without the hassle 


on Raspberry Pi is to stream them from 
another PC using Steam Link - here's 
how to set it up. 


T he quickest way to play modern games 


Install on Raspberry Pi OS 
Raspberry Pi OS has Steam Link in the repository, 
so you can easily install it! You can find it in the 
Software Installer, or simply install it from the 
Terminal using: 


You'll find it in the main menu under Games - 
just make sure Steam is running on your main PC, 
plug in a controller, and you're good to go. 


Li Raspberry Pi OS has Steam | 


Link in the repository, so you 
can easily install it! В 


Install on RetroPie 

If you have a dedicated retro gaming Raspberry Pi 
setup, you can still make use of Steam Link. Go to 
RetroPie Setup, scroll down to Manage Packages, 
and then go to ‘exp’ for the Experimental 
packages. There you'll find a steamlink package. 
Install it, and then find it in the Ports section of 
the main interface. 


sudo apt update : 
sudo apt install steamlink а 
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Xbox Cloud Gaming 


Want to try out the xcloud on Raspberry 
Pi? Our friends at Pi My Life Up have a 
guide: magpi.cc/xcloud 


Steam Link tips! 


For the best experience, make sure at 
least one of the systems in this setup 
is connected via an Ethernet cable. 
Preferably your PC running Steam and 
your Raspberry Pi will both be wired. 
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Linux games running natively on a Raspberry Pi 


Micropolis 


» magpi.cc/micropolis 


Created by the SimHacker team, this free and 


: Freeciv 


: > freeciv.org 


: As you may have gathered from the name, Freeciv is a clone of the Civilization 


open-source game is based on the original SimCity. : 
: multiplayer, and has a load of mods and scenarios for you to play around with. 


For those unaware of it, it's a simulation game 
which allows you to plan out and build a city while 
also facing any consequences your actions might 
result in. And, sometimes, giant monsters. 


How to install: 
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games, albeit the earlier ones. This version supports up to 126 people in 


: How to install: 


sudo apt install freeciv-client-sdl 
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SuperTuxKart 


Hurrican 
» supertuxkart.net 
» magpi.cc/hurrican 
This mascot kart racer includes mascots from : This game describes itself as ‘THE ultimate Turrican Mega-Mix’, 
all your favourite libre operating systems and s taking ideas from several instalments of the original franchise while 
software, including Tux, the mascot of Linux : at the same time expanding on its universe. It's a side-scrolling run- 
himself. This is a fun racer full of power-ups, much : and-gun game with a killer soundtrack. 
like your Mario Karts, Sonic Karts, or Diddy Karts, : 
and it even has a story! - How to install: 


Follow the instructions here: magpi.cc/hurricaninstall 
How to install: 
Download from the main website or follow the 
instructions here: magpi.cc/tuxkartinstall 


| Pingus 


|. > magpi.cc/pingus 


: A Lemmings-style puzzle game with little penguins instead. Basically, you 
: have to guide the penguins through a level using a variety of commands 
e EM p : you can give them, like dig, redirect, build a bridge, etc. Unfortunately, the 
== ee = ; penguins do not have any regard for their own well-being. 
STK DEVELOPMENT TEAM ess SUPERTUNKART CELEBRATING THE NEW ENGINE : 
=T JOERG Pda GAGNON «Я JEAN-WANUEL CLEMENCON ? : How to install: 


E OZONEONE wo CHRIS LEVTWYCEE 2 DAWID GAN oS DANTEL BUTUM no GLENN DE JONGHE 3 : v 


IE SACHITH SENEVIRATHE, CSABA 
THANKS TO GOOGLE SUMMER'S CODE a OUR AWESOME COMMUNITY :) 


DOWNLOAD AT SUPERTUXKART.NET | ) 
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Games (xm) heh afe 


Indie games galore for Raspberry Pi 


Ben Was Assimilated 


» magpi.cc/benassimilated 


Art Treachery 


With a very cool, low-colour aesthetic, Ben Was Assimilated , 
» magpi.cc/arttreachery 


is a hack ‘n’ slash game where things only move as you do, 
resulting in careful deliberation and interesting tactics. It also 


has Roguelike elements, including a permadeath option for : This game was made for the British Library Labs 
those wanting a real challenge. : Crowdsourcing Game Jam. You play an art thief who 

; has to steal specific objects from a museum. It’s 
How to install: А simple and short, but a pretty fun concept. 


Get it from the link. 


How to install: 


Fes * Get it from the link. 
toh gm M å 
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оњ 
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Zombusters: | Me Tp. E MD: 
Raspberry Pi Edition hy ei LU : 


» magpi.cc/zombusters 


A isometric, twin-stick shooter with Roguelike 
elements where you have to bust zombies with 
guns. Lots of guns. You can also play with up to 
four players on one Raspberry Pi for some excellent 
combo zombie take-downs. 


How to install: 
Get it from the link. 


SpaceTrader 


» magpi.cc/spacetrader 


This game runs in the Terminal for a different 
kind of playing experience. You're a trader in 
Earth's space port, and need to make your way 
around a changing economy and pirate bands to 
make as much money as you can. 


How to install: 
Get it from the link. 


gray water 


» magpi.cc/graywater 


Another Terminal game, this game takes a darker 

turn into horror with this simple description: 

*You enter an apartment building. You do not E ra y Wa г е r E 
know your neighbours.’ It’s not very long, but it 

is very effective, bringing new ideas to the classic 

command line-based game. 


How to install: 
Get it from the link. 
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| made available to everyone, in most cases 

| by releasing the source code. You can run 
them straight off your Raspberry Pi thanks to the 
community making them ARM-friendly. 


T hese games from yesteryear have been 


m As the space marine 
Doom Guy, you have to 
fight off the forces of hell El 


Doom (1993) 


» magpi.cc/doom 


A game so good, it defined a genre for years. 
Seriously - FPS games used to be called Doom- 
clones. As the space marine Doom Guy, you have 
to fight off the forces of hell with a large variety 
of guns and a rocking soundtrack. The source code 
was released by id Software in 1997, and became 
open-source in 1999, which is why there's been a 
long-running joke about trying to get every piece 
of tech to run it. 


How to install: 
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: Beneath a Steel Sky (1994) 


: > magpi.cc/steelsky 


: A classic point-and-click adventure game, Beneath a Steel Sky has been 

: available as freeware since 2003. It’s a cyberpunk story set in a dystopian 

1 Australian future and... well it's a story game, so we won't spoil too much. A 
: sequel for it came out just last year, so it's a great time to familiarise yourself 
- with it. 


: How to install: 
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Quake III Arena (1999) 


» magpi.cc/quake3arena 


Another id Software classic, and the granddaddy of 
multiplayer twitch shooters, Q3A was the bane of 
school IT administrators in the early 2000s because 
of how easily available it was. Only the demo data 
is free, but if you have a copy of the game, you can 
add the files yourself to get the full game. 


How to install: 


Minecraft (2011) 


» magpi.cc/mcpi 


Minecraft Raspberry Pi Edition is a free game on 
Raspberry Pi. However, it has not been officially 
updated in many years. You can still hack it with 
Python to do fun things, and we've covered that 
in the mag before. Minecraft Raspberry Pi Edition 
Reborn is an effort to mod it to be much closer to 
the Minecraft you can play elsewhere - it’s still in 
development, though. 


How to install: 
Follow instructions on the website linked above. M 
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RETRO GAMING - 


WITH 


_ RASPBERRY Р! 


ДЕО ИО І 


Retro Gaming with Raspberry Рі shows you how to set up а 
Raspberry Pi to play classic games. Build your own games console or 


full-size arcade cabinet, install emulation software, and download classic 
arcade games with our step-by-step guides. Want to make games? Learn 
how to code your own with Python and Pygame Zero. 


m Setup Raspberry Pi for 
retro gaming 


m Emulate classic 
computers and consoles 


m Learn to code your 
own retro-style games 


m Build a console, 
handheld, and full-size 
arcade machine 


BUY ONLINE: magpi.cc/retrogaming 
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Argon IR Remote 


DIMENSIONS: 
150 mm x 35mm 
x10mm 


POWER: 
2x AAA batteries 


COMMUNICATION: 
Infrared 


HARDWARE 
COMPATIBILITY: 
Argon ONE & 
EON cases 


SOFTWARE 
COMPATIBILITY: 
LibreELEC or 
Raspberry Pi OS 


Verdict 


Although the 
setup instructions 
could be 
improved, Argon4o 
has delivered a 
sleek, simple, and 
reasonably priced 
IR remote, both 
for Raspberry Pi 
media centres 
and homebrew 
projects. 


9., 


> Argon40 > magpi.cc/argonir » £9/S10 


Looking for a sleek minimalist remote for your Raspberry Pi media centre? 
PJ Evans sits back on his sofa and gets clicking 


makes for a brilliant way to access 

your favourite sounds and movies. Add 
Argon4o’s sleek ONE case and it looks as good, if 
not better, as any other set-top box. There's even 
mature software in the form of the LibreELEC 
operating system and Kodi media centre app. All 
that's missing is an easy way to control the action. 
The eagle-eyed may have noticed the ONE case's 
circuitry includes an IR sensor, and now Argon4o 
has made the companion Argon IR infrared remote 
control available. 

Thankfully, Argon4o has been watching 

other tech design teams rather than those of 
most modern TVs. What you get for your very 


U sing a Raspberry Pi 4 as a media centre 


А The lack of extraneous buttons and a small form factor make the 
Argon IR comfortable to hold and use 
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reasonable £9 is a minimalist, slim remote with 
just enough to make controlling Kodi a breeze. 
Basic directional control, selection, volume, and 
standard navigation work alongside a power button 
that works out-of-the box with any Raspberry Pi 4, 
regardless of operating system. It's light too, at 
just 65g with two AAA batteries. 


More than media 

If media centres are not your thing, or you have 
other epic plans for a remote control, Argon4o 
provides software that allows you to assign any 
key press to a button using the standard LIRC 
library with ease, making the addition of IR remote 
control to your project easier than ever before. In 
our tests, this worked flawlessly. However, we did 
have some issues configuring Kodi due to some 
missing steps in the supplied instructions. Once 
resolved, the remote performed admirably from 
across the room. El 


ДА minimalist, slim remote 
with just enough to make 
controlling Kodi a breeze 0 


А Youll need an Argon ONE case (or the forthcoming 
EON) to use the Argon IR 
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20% off your Flowcode purchase using code: 74И 


Use code at checkout: flowcode.co.uk/buy 
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AUDIO 


FEATURES: 
Up to 
96kHz/32-bit, 
102 dB SNR 
DAC, 92 dB 
SNR ADC, 
integrated DSP, 
3D effects and 
de-emphasis 


INPUT/ 
OUTPUT: 
Gold-plated 
3.5 mm jack 
for mic or 
stereo out 


GPIO: 
Pass-through; 
GPIO pins used: 
2, 3, 18-21, 26 


Verdict 


If you need a 
separate audio 
output (and/or 
mic input) for your 
Raspberry Pi 400, 
this provides one 
at little cost. 


8 10 


Berry 400 5 


> The Pi Hut > magpi.cc/dacberry400 » £17/S19 


Add an audio output, and mic input, to your 


Raspberry Pi 400. By Phil King 


hile Raspberry Pi 400 has an array of 
W ports at the rear, one notable omission 

is a dedicated socket for audio output. 
The DACBerry 400 S is designed to address this 
while also offering a mic input via the same gold- 
plated 3.5mm socket. 

The DACBerry 400 S fits onto the GPIO header 
at the rear of Raspberry Pi 400. While it’s fairly 
obvious which way up the board should go, care 
needs to be taken to line up its header with the 
GPIO pins correctly - with a small gap showing at 
the Pin 1 end. 

Get the alignment wrong and not only will you 
get no sound, but you may damage the board. This 
is something manufacturer OSA Electronics will 
be addressing in the second batch of boards, by 
introducing a small bump in the middle, to line up 
with a notch in the GPIO header surround. 


Let there be sound 

A one-line Terminal command installs the software 
needed to drive the DACBerry 400 S. At the time of 
writing, this required the earlier Buster version of 
Raspberry Pi OS (magpi.cc/buster), but it should 


А Make sure to connect the board to the GPIO header the 
right way around and align the pins correctly 


80 | magpicc | DACBerry 400 S 


А Тһе DACBerry 400 S has a gold-plated audio connector 
and pass-through for the GPIO pins 


2 Care needs to be taken 
to line up its header with 
the GPIO pins correctly @ 


be available in Bullseye soon. After rebooting, the 
audio will be routed through the DACBerry - with 
Raspberry Pi 400's audio chip disabled, so it's not 
easy to switch back if needed. It also works with 
OSMC and LibreELEC, among other OSes. 

The line-out audio signal is strong enough for 
decent volume on connected headphones, or you 
can use powered speakers or an amp. The sound 
quality is very good with a nice warm tone and 
strong bass, possibly due to DSP's integrated low- 
pass filter. The audio can be adjusted using the 
numerous settings in alsamixer, but OSA plans to 
introduce a GUI-based tool for this. 

A bonus is the ability to connect a microphone 
for recording, using the same 3.5 mm socket - OSA 
is also planning another DACBerry 400 model with 
a separate mic socket. Hl 
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10 Amazing: 
Starter kits 


These Raspberry Pi kits will 
help you take the first steps 
on your making journey 


Maybe thinking of getting one with any holiday 

money you received? Here are some great kits 
to help you get properly started with a Raspberry Pi or 
Raspberry Pi Pico. Hl 


D id you get a Raspberry Pi for Christmas? 


a Picade 


Arcade kit 


This mini arcade cabinet is a wonderful kit that allows you to 
create a high-quality retro games console, with a nice stick and 
buttons which can be upgraded in the future if you wish. 


magpi.cc/picade | £225 / $249 


Len 


a Raspberry Pi 400 
Personal Computer Kit 


All-in-one Raspberry Pi 


A box full of just about everything you need to create a PC - a Raspberry Pi 400, 
mouse, power supply, microSD card, and a nice Beginners Guide book. Just add 
a monitor or TV. 


magpi.cc/pi400info | £94 / $125 


v CamJam Edukit 
3 - Robotics 


ti Beginner's robot 


t A classic kit for beginners that lets 
you easily build and program a robot 
of your very own, and quite cheaply 
as well! You can even use the box as 
the chassis. 


magpi.cc/edukit3 | £18 / $24 


^ Grow Kit 


Automated herbs 


Growing your own herbs is a great 
way to not have to constantly buy 
fresh herbs for cooking, and the Grow 
Kit makes it very easy to keep them 
watered so they'll grow properly. 


magpi.cc/growkit | £30 / $40 


v Autonomous 
Robotics Platform 
for Pico 


Pico robot 


We're entering a new world of Pico robotics, 
and this Kitronik kit will get you going with 

it. Pico offers different advantages over 
Raspberry Pi for robots, so give it a look. 


magpi.cc/robotplatform | £41 / $55 
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BREAKOUT i BREAKOUT 2 


is explorer, 


1030 21 Jan21 


4 Pico Explorer Base 


Pico playground 


This board allows you to really explore what can be done with a Pico, with 
plenty of stuff for beginners and loads of things you can then build up from, 


thanks to its breakouts and screen. 


magpi.cc/picoexplorer | £22 / $29 


Electronics and microcontrollers 


Loads of little electronics bits that you can use with a Raspberry Pi as well as 


Pico. It comes with a little guide with several projects too. 


magpi.cc/discoverykit | £12 / $16 


» Monk Makes 
Project Box 1 


Intro to electronics 


With enough components to 
create ten projects, these Monk 
Makes boxes are a great way to get 
stuck in with a new Raspberry Pi. 


magpi.cc/projectbox1 | £12 / $15 
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EA 


a Raspberry Pi Pico 
MicroPython Learning Kit 


More electronics 


This is basically a bigger version of the Discovery kit with many 
more components to play around with. It even comes with a Pico. 


magpi.cc/learningkit | £32 / $43 


у 
Ф v. 
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a Grove Starter Kit for 
Raspberry Pi Pico 


Sensors and more 


This kit is a great way to play around with sensors and motors and 
more without needing to worry to much about wires - just 
the programming. 


magpi.cc/groestarterkit | £44 / $59 


Raspberry Pi Starter kits | magpicc | 83 


ШШШ АРІ | RESOURCES 


Learn to code in Scratch 


Bright colours and an array of projects to get stuck into make Scratch 
the ideal first step into coding. By Rosie Hattersley 


| Raspberry Pi Projects 


Raspberry Pi 
Foundation 


CREATOR 


Price: 
Free 


magpi.cc/ 
scratchprojects 


Raspberry Pi provides a 

heap of projects and games 

to help you get to know 
Scratch, complementing 
those offered by MIT. These 
projects challenge you to beat 
the buzzer, press particular keys 
corresponding to colours in 
order to create sounds, or to log 
how many birds of a particular 
hue appear in your virtual 
wildlife camera. 

The skills you learn can then 
be used for your own Raspberry 
Pi projects. Videos at the start 
of each project show you what 


3O LED science Gmpay with Seratch 


you'll create, with lists of 
materials needed and details of 
how it all fits into educational 


with code! Web-based Trinkets 
enable you to practise and check 
your code works. Step-by-step 


learning goals. Of course, you 
can just enjoy making things 


Scratch courses 


Teach yourself or others with 


a bit of online a 


ssistance 


CS FIRST 


A free computer science curriculum that makes 
coding easy to teach and fun to learn. 


T 


A CS First is a great place to learn Scratch skills 
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COURSERA 

Coursera has a range of Scratch 
courses to help you learn the 

visual programming language. 

The "Introduction to basic game 
development course" is a great 
place to start, before moving on to a 
range of more advanced courses. 

> magpi.cc/courserascratch 


CS FIRST 

Learn Scratch skills yourself, as 
well as getting ideas and project 
plans for use in the classroom or at 
a coding club you might be involved 


instructions and diagrams are 
included throughout. Ш 


with. Separate logins for individual 
students and educators mean that 
everyone can learn at their own 
pace, and backup resources are 
always on hand. 

> magpi.cc/csfirst 


UDEMY 

Ideal for teachers or individuals, 
classes are aimed at adults keen 
to learn coding in order to teach it 
to others. The course focuses on 
problem-solving, computational 
thinking, and creativity. 

> magpi.cc/udemyscratch 


Й Scratch ideas 


MIT 


Price: 
free 


CREATOR 


scratch.mit.edu/ideas 


^ 


An ideal starting point for 
newcomers to coding, MIT 
(Massachusetts Institute of 
Technology) is the home of 
Scratch. Scratch is a visual 
means of learning to code and 
provides an accessible route 

to learning using images and 
animations. Importantly, the 
visual approach mimics the 
types of instruction you will 
encounter when using text- 
based coding languages such as 
Python to program Raspberry Pi, 
Arduino, and other computers. 


Start by watching the Getting 
Started video, which shows how 
instructional blocks are used to 
build up actions for each sprite 
or character, after which you 
can jump straight into using 
Scratch yourself. 

The basic premise of Scratch 
is that coding can be done by 
ordering physical actions. This is 
as simple as dragging the blocks 
you want to use over to the 
workspace, and then clicking the 
green flag to play each action. 
Brief video overviews introduce 
topics such as Making Music, 
Imagine A World, and Video 
Sensing, providing a good steer 
before you give each one a try. 
Learner and educator info cards 
keep you on track. 

Open Scratch 3 (under 
Programming in the accessories 
menu) and click on Tutorials, or 
visit Scratch online. El 


| CS50 Scratch 


Harvard 


Price: 
free 


CREATOR 


magpi.cc/cs5oscratch 


CS50 is Harvard University’s 
highly acclaimed introduction 
to computer science and 
programming. Most of the 
course materials cover text- 


x |e 


based languages, such as 

C, but this “Introduction to 
programming with Scratch” 
introduces computer concepts 
using visual programming. 

It's a great mix, combining 
Harvard's know-how, 

excellent video seminars, 

and deep explanations with 
Scratch’s easy-to-understand 
interface. The course covers key 
programming concepts such as 
functions, conditions, loops, 
variables, and abstraction. When 
you've finished you can move on 
to further CS50 courses. El 
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Learn along 


with others 


Learn coding 
independently or as 
part of a peer group 


SCRATCHED 


Ideas for how to use Scratch 


across the curriculum, from 
music and maths to literacy 
and art. This site contains lots 
of ready-made quizzes and 
challenges, plus Scratch- 
based animations that précis 
important topics you want 
students to remember. 

> magpi.cc/scratched 


SCRATCH.IE 

A useful set of Scratch- 
based activities separated 
into primary school-age and 
post-primary (age 12 upwards, 
reflecting the Irish education 
system). As with other sites, 
teacher and students have 
their own login and learners 
can progress independently, 
choosing which projects to 
complete when. We'll be 
heading straight to the retro 
gaming option! 

> magpi.cc/scratchie 


CODERDOJO 

Part of the Raspberry Pi 
community, CoderDojos 
provide both online projects 
you can complete, and in- 
person groups where you 
can join other young coders 
working on Scratch, Python, 
and HTML challenges. Click 
the Resources link for ready- 
made projects to try. 

> magpi.cc/coderdojo 
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Ь This model railway's train 
signal is automated via 
Raspberry Pi 


Stewart Watkiss 


The Penguin Tutor 


> Name Stewart Watkiss | 


> Community role STEM Ambassador | 


tewart may be familiar 
S to long-time readers 

of The MagPi - he’s 
written articles for it and had 
his projects featured in these 
very pages many a time. He’s 
also a well-known face in the 
community, having been around 
since the beginning. 

“I became a member of the 
Raspberry Pi community from the 
launch of the first Raspberry Pi,” 
Stewart tells us. “I couldn’t wait 
to get my hands on one. Being a 
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» Occupation Data Centre Manager 


member of the community has 
opened new doors for me; it's 
given me an opportunity to make 
projects which were previously 
out of reach, to teach skills to 
others, and fulfil my ambition of 
writing a book." 


What is your history with 
Raspberry Pi? 

As a supporter of Linux, I first 
heard about Raspberry Pi a few 
days before the launch. I heard 
it was a new low-cost Linux 


» Website penguintutor.com 


computer, and wanted to get 
hold of one. I was up early on 

the day of the launch, but didn’t 
manage to place an order until 
ater that day when the retailers’ 
websites had recovered. It was 
then a few months’ wait before 
it was delivered. Once I had one, 
it became clear that it was much 
more than just a Linux computer, 
and the GPIO connectors 

meant that I could use it for so 
much more. 

I created some initial projects 
and then got involved with more 
community events, giving talks 
and workshops at Raspberry 
Pi events, including some in 
Cambridge and those nearer 
home at Birmingham. 

Ialso signed up as a STEM 
ambassador, and I’ve run some 
Code Clubs in schools. 


How long have you been 
making for? 

I started getting interested in 
making during the early 1990s 
whilst studying electronics. 
After finishing university, I 

no longer had access to the 
equipment needed to go beyond 
basic projects, so I dropped the 


INTERVIEW | MägPi 


A The Bee Box was one of the first projects Stewart made with Raspberry Pi, 
working with his kids on it 


electronics enthusiast 


into electronics, worki 
some simple projects. 


making took off. I star 


it grew from there, lea 
skills and progressing 


adventurous projects. Since then, 


hardware side and concentrated 
more on software projects. 

I bought my first Arduino in 
2008, which made electronics 
much easier and expanded 

the scope of what the home 


could 


achieve. I started to get back 


ngon 
twas 


really in 2012 when I first got 
my first Raspberry Pi when my 


ted with 


some simple projects and then 


rning new 
to more 


Гуе now got a 3D printer as well, 


which has expanded the scope of 


what I’m able to do. 


Could you tell us about writing 


for The MagPi in the early days? 


I wrote a few articles for The 
MagPi when it was a purely 
volunteer magazine. I took 
some projects that I'd created 
already and created a write- 
up for the magazine. At the 


time, I was wanting to 


write а 


book and writing for The MagPi 
was a great way to get more 
experience. Despite being written 
by volunteers, it followed all the 
same process as a professional 
publication, including a technical 
review and proofreading. I was 
impressed by how professional 


it was, and it was 


valuable 


experience for when I got my first 


book deal. 


What is your favourite thing 
that you’ve made with a 


Raspberry Pi? 


My favourite project is one of 
my first, known as the Bee Box. 


This was the first 
did with my child 


project t 
ren, and 


hat I 
really 


enjoyed that we were able to work 
together on it. It was a minibeast 


project for schoo 


using so 


me 


reed switches to determine the 


position of a mod 
showed a picture 


el bee. It 
on the sc 


and included sou 


then 
reen 


nd effects. Hl 


Stewart's stuff 


A. This 3D-printed house had lights controlled 
via a Raspberry Pi and touchscreen 


“I've written two books 
(or three if you count the 
second edition). The first 
is Learn Electronics with 
Raspberry Pi, which has 
even been translated to 
Chinese, and Beginning 
Game Programming 

with Pygame Zero which 
was published in 2020. 
More recently, I've been 
focused on creating 
content for my YouTube 
channel, penguintutor, 
and website." 
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MagP1 
Monday 


Amazing projects direct from our Twitter! 


very Monday we ask the question: have you 
made something with a Raspberry Pi over 
the weekend? Every Monday, our followers 
send us amazing photos and videos of the things 
they've made. 
Here's a selection of some of the awesome things we 


© Dr Footleg - Roboteer 
¥tootlog 


Replying to GThet/agf 


P 


af 


| designed and 3D printed a case for my new Pi Zero 2 
W and the Pi camera which mount on aluminium 
extrusion, then set it up running OctoPrint on my 
3DPrintMill. 

(Pi case was remixed from an original idea posted by 
Emily Murry on grabcad.com/library/raspbe... ) 
#MagPiMonday 


got sent this month, and we got quite a lot! Remember 
to follow along at the hashtag #MagPiMonday! El 


We love a bit of OctoPrint here, and this 
is a great use of Raspberry Pi Zero 2 W 
by Dr Footleg. 


We'd have to do some maths to figure 
out just how much more powerful this 
Zero 2 W array would be - orders of 
magnitude at least. 


This is an interesting console idea, which 
seems to have taken some inspiration 
from the Switch. 


As long as there are ultrasonic sensors 
attached to Raspberry Pi, there will 
be theremins. 


The recycling of this drift wood into a tide 
indicator is very cool. 


Open-source farming robot is an excellent 
combo of words - we're keeping our eye 
on this! 


The bare mental synth project keeps growing. 


Lorraine always comes up with great and fun 
projects, and this is no different. 


This cute plushy night light is something that 
should exist as a product, we think. 


Getting readings to look good and be 
informative at a glance is an art in itself. 
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##magpimonday no Christmas decorations yet - but i 
am building a Clustered-Pi based on the Cray-1 super 
computer from 1976. #cluster #raspberrypi 
ttraspberrypizero2 #ansible #opensource #stem 


#3dprint #3Dprinting 


based handheld games console for retro games and 
budding games developers. 


A bit limited at the moment (waiting on software 
updates), but I've been taking a look at the hardware. 


penguintutor.com/news/raspberry 


#MagPiMonday 
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әс 


Kevin McAleer 
Dkevsmac 
Working on my tide level and direction drift wood 


Replying to @TheMagf integration 


l've created a raspberry pi zero 2 based theremin using 
two range finders and a few lines of python (link in bio 
to the video) #MagPiMonday #raspberrypi #python 
ttopensource #STEM 


diyelectromusic 


*dyelectromu 


Replying to GTheMagP 


I've added PWM audio output to my (original) Pi Zero to 
use with my "bare metal" synth. 


#MagPiMonday XL McUnd 


ectromusic.wordpress.com/2021/11/12/ras... 


I'm creating an interactive light up window for my 
neighbours/passing strangers to play with! It's got a 


Yes! | am doing a major new rev of the motherboard for МЕ ажы vie Р. 4 - Е - - - micro:bit on the outside controlling buttons. Inside isa 
our raspberry pi powered open source farming robot! It 0—40 +, 000000 raspberry pi connecting to and controlling the lights. 
= же ары т © ыы o 
will be open source (done in Kicad) once | am done o - uode РЕСЕ: 
with it. My microni? Braspberrypl interactive light up wincow is working! m squishing 
the wires between my hands os Capacitive buttons, not clap sensors! Just needs 
Ө Taylor Alexander gg — СТ люка bolting to the wall and to be made pretty 


Getting much closer now. Showing two views of the main board, then the serial 
board and the power distribution board. PDU switch is out of stock tho so I have 
to rework that to use P channel MOSFETs. Will do a full BOM stock check (and 
order!) before going to fab. twitter.com/TLAlexander/st.. 


I've been working on this Raspberry Pi Zero 2 W based 


#LoRaWAN CO2 sensor node for @thethingsntwrk. 
The Python code still needs a little tweaking to make 
the information on the #5501306 OLED easier to read. 
#MagPiMonday #loT #stem #opendata 
#CitizenScience 


3MsHaughs 


Replying to &9TheMagPi © TOO ок Commuting - Nov 20 


WRebdo yell. Yee-haw Bullseye! PITS is ready for t & transmits all readings from 
@evercrion SCO40 COO concer as Mopendata via @trethingertwrk to 
G@opensencemap. 


Finished my Pico Plushy for baby boy! Fun project © 


WTIN V3 WLORAWAN-node based сп GRatoberry Рі иР/мо2 with GAcatruit 
FLORA Radio Bonnet. WMINT MOT тоту FCO2 FSCD4x 
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Replying to @TheMagPi 


This weekend I've been working with the Raspberry Pi 
Pico and RFID tags and MicroPython - video here! 
youtu.be/hV9GTqXLMpg #MagPiMonday 
ttraspberrypipico #pico #raspberrypi #robots 
ttrobotics #micropython #smallrobots #stem 
ttopensource 


e Andrew Porter 
2defsdoor 


Replying to @TheMagP 


Pico inside (tm) 


Christmas lights are not up yet, here is last years. 
Controlled using Pi with Energenie remote control 
sockets. 


Saves climbing under the tree to get to the sockets. 
Lights turn on and off automatically. 
Manual override using a Pi touch screen. 


youtube.com 
Christmas light controlled by Raspberry Pi. Home automati 


This video exp! stmas lighting display | 


м it's controlled using 3 Raspberry. 


0:05 1K views - B 


After a break from all things Pi for a while, | finally 
finished a build i've wanted to do for about 6 years - a 
#raspberrypi based central heating thermostat. 
Includes Timer, thermostat, monitor and data logger! 
Plus you could probably play games on it too! 


Tl. We'eup pondering this orb. 


12. RFID and robotics is a great combo, as 
it can help automate movement. 


13. Sendus your Christmas projects when 
you've finished them, we'd love to see! 


14. This thermostat design is very nice, 
and we hope it helps keep Mark warm 
throughout the winter. 
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Best of the rest! 


Other stuff we've seen this month from the community 


SCIENCE BY SOLAR 


We've covered collaborative computing in 
the past with software like BOINC, which lets 
you donate PC power to help with protein 
folding or data analysis of some kind for 
scientific projects. Jamie emailed us about his 
Science by Solar project, which is a Raspberry 
Pi Zero running entirely off solar power that 
connects to the World Community Grid. 

The website for his particular project 
is even run off this solar-powered Zero 
(sciencebysolar.me), and shows stats for 
what its currently working on. 

"Although this tiny system's contribution 
is small, my goal was the create a self- 
sustaining solar computer that actually had 
some reasonable use,” the website states. Protein ta rget 
"The calculations this system performs do 


actually contribute to real research and real Candidate bei ng eva luated 
results - just slowly in this case." 


PICOMITE: BASIC COMPILER 


Another email we got this month was from Peter 
about a compiler for BASIC on Raspberry Pi 

Pico. For those a bit younger, BASIC is an earlier 
language used mostly in the 1980s and early 
1990s. Having something like Pico run a compiler 
for it is very impressive, allowing you to actually 
program Pico in BASIC itself. 

"Using MMBasic, you can use communications 
protocols such as І2С or SPI to get data from a 
variety of sensors," the project website reads. "You 
can save data to an SD card, display information 
on colour LCD displays, measure voltages, detect 
digital inputs, and drive output pins to turn on 
lights, relays, etc. All from inside this low-cost 
microcontroller." Find out more about it here: 
magpi.cc/picomite. Е 
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Your Ё 


Letters 


P Features Ed Rob's Dutch 
family enjoy seeing this 
version of The MagPi 


The MagPi translated 


I’ve been subscribed to the 
Dutch version of the magazine 
for several months and love 
getting it. I have a subscription 
query though, who should I 


4 Bullseye is the 


recommended version contact? Are they the same 
NOE. iis. ү people I should contact if I have 
using an older version a project to show? 
Mo via Email 
Each of the translated versions 
I'm working on a new project, and I was wondering whether or not to use the new of The MagPi have specific 
Bullseye version of the OS or stick with Buster for now as I know it? contact forms on their website 
(magpi.nl, magpi.fr, magpi.de, 
Alex via Facebook etc.) and they are the best places 
to go about your subscription to 
Generally, Bullseye is very similar to Buster, so you shouldn't have many issues having to them. As for submitting projects, 
learn anything new - mostly it's software updates and security fixes. Some projects may you can definitely send them our 
work a little smoother on Buster though, especially ones that involve the camera. For that, it way, and they will eventually 
might be better to use the new Legacy version of Raspberry Pi OS. You can find a copy in make their way into the 
Raspberry Pi Imager and read all about it on Raspberry Pi's website (magpi.cc/legacy). translated editions! 


92 | magpicc | YourLetters 


I saw that there was a pop-up Raspberry Pi Store in 
London recently. Do you have any other plans for pop- 
ups, maybe in other countries? 


Dana via Twitter 


Unfortunately there are no plans, that we know of, for other 
pop-up versions of the Raspberry Pi Store. However, that's 
the nature of pop-ups really! If there is enough demand, I’m 
sure the team will keep note in case the opportunity arises. 
Never say never! 


The two-day London pop-up looked very swish 
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RASPBI 
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The only guide you 
THE OFFICIAL need to get started 
with Raspberry Pi 


How to use your 


new computer * Learn how to set up your Raspberry Pi, 


install an operating system, and start using it 


* Follow step-by-step guides to code your 
own animations and games, using both the 
Scratch 3 and Python languages 


* Create amazing projects by connecting 
electronic components to Raspberry Pi's 
GPIO pins 


£10 with 
worldwide delivery 
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N 
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ATONE OF FIVE Y 


PICOSYSTEM 


CONSOLES! 
IN ASSOCIATION 
WITH PIMORONI 


The amazing PicoSystem 

is a great handheld system 
powered by RP2040 that lets 
you prototype and play games 
quickly. Last month we gave 

it 9/10, and now you have a 
chance to win one of five. 


Head here to enter: magpi.cc/win | Learn more: magpi.cc/picosystem 


Terms & Conditions 


Competition opens on 15 December 2021 and closes on 27 January 2022. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry Pi Foundation, 
the prize supplier, their families, or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any 
publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don't like spam: participants’ details 
will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange 


delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, 
or associated with, Instagram or Facebook. 
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Decade 


2022 marks a decade of Raspberry Pi, How things 


hen I first heard about 
W Raspberry Pi, it was late 
2011 and the technology 


landscape was quite different. The 
Motorola Atrix and Xoom were the 
premier Android phones, iPhone’ s 
signal went wonky if your finger was 
in the wrong place, and the Xbox 360 
and PS3 were about halfway through 
their quite extended life cycle. With 
months until Netflix streaming 
would hit the UK, I was reading 
about the upcoming Raspberry Pi 
and getting pretty interested. I 
had no idea what I could use it for, 
but I knew I could definitely use 
it for something, even if a Twitter 
acquaintance thought it would 
flop like the Ouya (they have since 
deleted the tweet, ending with ‘it 
doesn’t even have a battery’). 
When Raspberry Pi came out, I had 
just started writing for a long defunct 
Linux magazine at a now dead 
publisher, and we were immediately 
enthralled. I spent years writing 
tutorials using a 256MB Raspberry 
Pi 1 Model B - turning Raspberry 
Pi into robots, media centres, file 
servers, routers, BOINC nodes, and 
much more. One day, I even managed 
to break the entire office LAN 
while playing around with network 
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have changed. 


settings, oops. It was a lot of fun 
though, and I learned loads doing it. 


Late bloomer 

I was one of the kids that grew up in 
the late nineties and early noughties 
who experienced the loss of proper 
computing lessons at schools, so to 
be able to learn to code and learn 
practical programmable electronics 
in my twenties was a huge thing for 
me. It’s one of the reasons I landed 
on The MagPi in 2015, and more 
importantly, the reason I have 
stayed for around 80 issues. 


2 The passion of the 
community that first 
year was electric Ø 


Seeing the passion of the 
community that first year was 
electric. When we put out issue 40 
with Raspberry Pi Zero on the cover, 
we thought it might be popular, but 
we didn't realise just quite how 
popular. It took about a week for the 
constant stream of messages from 
people wanting to get a copy to die 
down, and it took years for us to 


By Rob Zwetsloot 


stop getting messages asking if we 
had any left at all. 

Since then, I’ve been through 
many things with Raspberry Pi. The 
launch of Raspberry Pi 3, the AIY 
Vision Kit we did with Google, 
sending Raspberry Pi to space, new 
cameras, Raspberry Pi 4, Raspberry 
Pi 400, Raspberry Pi Pico, and 
recently Raspberry Pi Zero 2 W, just 
to name a few. 


Now where? 

As the second decade of Raspberry Pi 
ooms ahead, my enthusiasm hasn't 
died down a bit. I still get new ideas 
every month for something to do with 
Raspberry Pi, and I will never cease to 
be amazed at the creativity of the 
community and how much they've 
supported us over the years. РП be 
right here with you to see what 2022 
brings to Raspberry Pi, and the ever- 
changing world it's helping. mM 


Rob Zwetsloot 


Rob is nearly 35 and has decided that 
makes him very old, despite being born 
the same year as Star Trek: The Next 
Generation started. 
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Displays Cases Project Kits Add-on Boards 
HATs Arcade Cameras Cables and Connectors 
Sensors Swag Power Options GPIO and Prototyping 


Partner and official reseller for top Pi brands: 


_ X and many 
Kadafruit sparkfun. РІМОКОМІ pm others! 


HIGHPI PRO 


.———————— The new case from the HiPi.io team —————* 


€ Rapid tool-free assembly and disassembly € Secure microSD card cover 
€ Large internal volume for HATs € VESA mount support 


e Compatible with Pi 2/3/4 e Molding-configurable output ports 


e Multiple lid options customizable for volume orders 
€ Passive & Active Cooling options e Printed logo for your branding 


Available at these great Pi stores: 


Js -- xA. 
&-PiShop.us Ё РіЅһор.са  (*fPiShop.mx €zPiHut Рі-бнор.сн Welectron. 


Contact your favorite Pi store if it's not listed here 


